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PREFACE 


Organization of This Book 


Required Reading 


This book describes the internal logic of the Virtual Storage Access Method 
(VSAM) and contains diagnostic information. It is directed to maintenance 
personnel and development programmers who require an in-depth knowledge 
of VSAM’s design, organization, and data areas. 


This book has the following major divisions: 


e “Introduction,” which describes the use of VSAM, how VSAM fits into the 


operating system, how VSAM interacts with the operating system and the 
user’s program, and the major components of VSAM. 


“Method of Operation,” which describes the functions performed by 
VSAM. 


‘Program Organization,”’ which describes the information contained in 
VSAM program listings and the flow of control between modules. 


‘Directory,’ which lists VSAM modules and the method of operation 
diagrams related to each module. 


“Data Areas,”’ which describes control blocks used by VSAM and 
describes the format of VSAM data and index records. 


“Diagnostic Aids,” which contains useful information for locating the 
cause of problems in the VSAM procedures. 


‘Glossary,’ which defines terms relevant to VSAM, and lists abbreviations 
and acronyms used in this book and in the VSAM program listings. 


“Index,” which is a subject index to the book. 


The following book should be read and understood before using this one: 
e OS/VS Virtual Storage Access Method (VSAM) Programmer’s Guide, 


GC26-3838, which introduces VSAM concepts and contains definitive 
explanations of VSAM macros. 
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Related IBM Publications 


Using This Book 


Introduction to the IBM 3850 Mass Storage System (MSS), 
GA32-0028 


OS/VS Data Management Macro Instructions, GC26-3793 

OS/VS Mass Storage System (MSS) Planning Guide, GC35-0011 
OS/VS Message Library: VS2 System Messages, GC38-1002 

OS/VS Virtual Storage Access Method (VSAM) Options for Advanced 


Applications, GC26-3819 


OS/VS2 
OS/VS2 
OS/VS2 
OS/VS2 
OS/VS2 
OS/VS2 
OS/VS2 
OS/VS2 
OS/VS2 
OS/VS2 
OS/VS2 


Access Method Services, GC26-3841 

Catalog Management Cross Reference, SYB6-3843 
Catalog Management Logic, SY26-3826 
Checkpoint/Restart Logic, SY26-3820 

DADSM Logic, SY26-3828 

Data Areas, SYB8-0606 

I/O Supervisor Logic, SY26-3823 

JCL, GC28-0692 

Open/Close/EOV Logic, SY26-3827 

Supervisor Services and Macro Instructions, GC28-0683 
System Logic Library, Volumes 1-7, SY28-0713 through 


SY28-0719 (All seven volumes can be ordered as SBOF-8210.) 


OS/VS2 


System Programming Library: Debugging Handbook, Volume 


1, GC28-0708, and Volume 2, GC28-0709 (Both volumes can be 
ordered as GBOF-8211.) 


OS/VS2 System Programming Library: Service Aids, GC28-0674 


OS/VS2 System Programming Library: System Management Facilities 
(SMF), GC28-0706 


OS/VS2 VSAM Cross Reference, SYB6-3842 


This book is designed to be used with the VSAM program listings in the 
microfiche for VSAM and with OS/VS2 VSAM Cross Reference, 
SYB6-3842, also on microfiche cards. Cross-reference reports are described 
in “‘Microfiche Cross-Reference Aids” in “Diagnostic Aids.” 


The diagrams in ‘““Method of Operation” describe the major functions 
performed by VSAM; these diagrams are intended to be your key to a module 
name (and procedure name, as appropriate) in the listing. See ‘““Reading 
Method of Operation Diagrams” in ““Method of Operation” for a description 
of how to read these diagrams. For information on what is available in the 
program listings, see ““Module Prologues”’ in ‘‘Program Organization.” 
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SUMMARY OF AMENDMENTS 


C 


Release 3.7 


VSAM SNAP Dump Facility 


To increase the serviceability of VSAM, the VSAM SNAP dump facility has 
been added to provide hexadecimal dumps of VSAM-owned control blocks in 
CSA. Included in the dump are: 


« The JSCBSHR field of the JSCB (used by VSAM to locate the VAT) 


e The control blocks for open VSAM data sets processed with the global 
shared resources (GSR) option 


e The control blocks making up the GSR pool 


e The VGTT chain for the ASCB associated with the TCB being dumped 
and any PSBs associated with these VGTTs 


The dump facility is described in “Diagnostic Aids.” 


Control Block Manipulation Macros 


Enhanced VSAM 


Changes to support improved control block manipulation macro processing 
were made in 


e« Diagrams CA and CB 


e« ‘‘Data Areas,”’ where KEYWDTAB, a branch table that controls execution 
of IDA019C1 and supports processing of the control block macros, is 
described 


« “Diagnostic Aids,” where a new return code, issued when a block to be 
displayed or tested does not exist because the data set is a dummy data set, 
has been added 


VSAM has several new functions and data structues for the independent 
component release of VS2 Release 3: alternate indexes, Checkpoint/Restart 
processing, spanned records, relative record data sets, processing the index of 
a key-sequenced data set, shared resources among data sets, improved 
control-interval processing, backward sequential processing, catalog recovery, 
and virtual-storage management. These additions to VSAM change this logic 
manual in all its sections: method of operation diagrams (HIPOs), program 
organization figures (compendiums), directories, data areas, and diagnostic 
aids. The directories identify all the new modules and external procedures and 
indicate which HIPOs and compendiums refer to them. 


Method of operation diagrams have been added for Data-Set Management to 
document recovery-termination processing. 


The detailed descriptions of some control blocks, for which you were 
previously referred to OS/VS2 Data Areas, are included in this book. 


The index has been expanded to include more proper names: 


e Modules and external procedures are included with a page reference to 
the ‘‘Directory.”’ 
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Alternate Indexes 


Checkpoint/Restart Processing 


Spanned Records 


Relative Record Data Set 


ie 


cn ncn 


e Internal procedures and program instruction labels are included with 
page references to the pages where may appear. 


Alternate indexes for key-sequenced and entry-sequenced data sets add 
control blocks and complicate control block interrelationships. Opening and 
closing a path (a base cluster and the alternate index through which access is 
gained to it) more than double the number of HIPOs for 
Data-Set-Management. Access by way of a path and alternate-index 
upgrading change and add HIPOs to Record Management. 


Checkpoint/Restart processing changes four HIPOs, and adds five HIPOs, 
two program organization figures, and four control blocks. 


Having data records longer than one control interval changes a number of 
HIPOs in Record Management. It changes the contents of control information 
in the RDFs in a control interval. 


The relative record data set brings to three the number of types of VSAM 
data sets. It changes the contents of control information in the RDFs in a 
control interval. It changes HIPOs and adds a HIPO to Record Management. 


Processing the Index of a Key-Sequenced Data Set 


User access to the control intervals of a prime index changes HIPOs in 
Record Management to include the GETIX and PUTIX macros. 


Shared Resources among Data Sets 


Shared buffers, I/O-related control blocks, and channel programs among data 
sets for processing add control blocks and change control block 
interrelationships. Building and deleting a VSAM resource pool add a HIPO 
to Data-Set Management for the BLDVRP and DLVRP macros add a section 
to “Diagnostic Aids’’ to describe recovery with global shared resources. 
Managing I/O buffers adds HIPOs to Record Management for the 
MRKBER, WRTBER, and SCHBFR macros. 


Improved Control-Interval Processing 


Backward Sequential Processing 


Catalog Recovery 


Improved control-interval processing changes HIPOs in Record Management 
to show the bypassing of certain functions for faster processing. 


Backward sequential processing changes HIPOs in Record Management to 
include processing data records in descending sequence by RBA or key. 


The optional recovery function that enables users to recover or restore data 
sets changes HIPOs slightly in Data-Set Management and Record 
Management. 
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Virtual-Storage Management 


Release 3 


Release 2 


I/O Management 


Security and Integrity 


The management of virtual storage has been centralized in Virtual-Storage 
Management, which controls most requests for storage. It adds control blocks, 
which are described in “‘Virtual-Storage Management”’’ in “‘Diagnostic Aids.”’ 


Staging and destaging of data between mass storage and direct-access storage 
is added for the IBM 3850 Mass Storage System. 


For communication with the VS2 I/O Supervisor, the IOB control block is 
replaced by a set of three control blocks: IOMB, IOSM, and SRB. 


Interface Between VSAM Record Management and VS2 I/O Supervisor. The 
function of putting together a channel program for issuing STARTIO has 
been separated from Record Management to stand logically as an interface 
between Record Management and the VS2 I/O Supervisor. 


Interface Between VS2 Auxiliary Storage Management and I/O Supervisor. 
VSAM I/O Management serves the same function for paging I/O between 
real storage and external page storage. It is the programming interface 
between the VS2 Auxiliary Storage Manager and I/O Supervisor. 


OS/VS2 multiprocessing requires changes in the way serially reusable 
resources are shared. A scheme of software locks that programs must obtain 
and free in order to use certain resources replaces hardware disabling. The CS 
instruction (compare and swap) is also used to ensure the integrity of serially 
reusable resources. ENQ/DEQ and the TS instruction (test and set) are still 
used in OS/VS2, Release 2. 


I/O Management, Data-Set Management (Open and Close, for both VSAM 
and the ISAM Interface), and End of Volume (considered logically as part of 
Record Management) use the local memory lock to protect VSAM control 
blocks when chaining them. They obtain or release the local memory lock 
with the SETLOCK macro. Data-Set Management also uses the CS 
instruction when chaining DEB control blocks or modifying UCB 
information. 


Most of the processing of I/O Management is in supervisor mode. It uses the 
MODESET macro to swap storage-protection keys. Data-Set Management 
runs primarily in storage-protection key 0 (as does End of Volume). 
ISAM-Interface Open and Close run primarily in the user’s key. These 
modules use the MODESET macro to swap keys when transferring control to 
and from OS/VS Open and Close. Record Management (with the exception 
of End of Volume) continues to run in the user’s key, as in OS/VS1 and 
Release 1 of OS/VS2. 


VSAM protects crucial I/O control blocks by placing them in protected 
subpools. A user of VSAM cannot modify these control blocks and cannot, 
therefore, interfere with the operation of the system. VSAM Open and Close 
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Recovery and Termination 


Page-Space Preformatting 


work with copies of ACB control blocks to prevent a user from interfering 
with the system. ISAM-Interface Open and Close don’t work with copies 


since they run in the user’s storage-protection key and thus provide no system 


processing to be interfered with. 


OS/VS2’s philosophy of recovery is to avoid re[PLing the system and to free 
up resources claimed by a failing task in order to be able to continue 
processing without contending with fragmented resources. The system must 
be able to reclaim actual resources and slots in control tables. 


The modules of I/O Management have functional recovery routines that get 
control from VS2 Recovery Termination Manager when an error occurs in 
I/O Management. A recovery routine releases various resources (such as the 
local memory lock, if it has been obtained) and may cause information to be 
recorded in SYS1.DUMP (with the SDUMP macro) or in SYS1.LOGREC 
(with the SETRP macro). 


Data-Set Management and End of Volume share a recovery routine that gets 
control from the VS2 I/O Support Recovery Routine (which is an ESTAE 
routine) when an error occurs during the processing of these modules, and 
they share a Task Close Executor that gets control from VS2 Task Close for 
task or memory termination. 


The recovery routine causes information to be recorded in SYS1.DUMP and 
SYS1.LOGREC concerning the processing that preceded an error. Open, 
Close, and End of Volume have been altered to leave various audit 
information in the Open/Close/End-of-Volume Work Area for this purpose. 


The Task Close Executor frees up storage in the system area. 


ISAM-Interface Open and Close also have a recovery routine that runs under 
control of the ESTAE routine mentioned above. This routine frees up ISAM 
Interface work areas following errors from which recovery cannot be made. 


VSAM in Release 2 of OS/VS2 recognizes the special case of a page-space 
data set being opened for output. When it occurs, VSAM makes the 
calculations required for preformatting, then transfers control to the 
Control-Area Preformat routine of Record Management to preformat all of 
the control areas that comprise the page-space data set. 
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INTRODUCTION 


Virtual Storage Access Method (VSAM) is an access method for use with 
OS/VS1 and OS/VS2. VSAM is used with direct-access storage to provide 
fast storage and retrieval of data. 


VSAM’s record format is different from that of other access methods. All 
VSAM records are stored in control intervals. A control interval is a 
continuous segment of auxiliary storage. The records are ordered according to 
values in a key field or according to when they were stored. With 
key-sequenced data sets, the user can gain access to a record by specifying its 
key or its relative byte address (RBA). With entry-sequenced data sets, the 
user Can gain access to a record only by specifying its RBA. For additional 
information on VSAM records and how they are stored, see ‘“‘Data Areas.” 


User programs that contain Indexed Sequential Access Method (ISAM) 
macros can be used to process records in a VSAM data set. The ISAM 
interface program that allows the use of ISAM macros builds the necessary 
VSAM control blocks when an OPEN macro is issued and ensures that 
VSAM control blocks are properly initialized when subsequent requests are 
made for reading or writing records. 


Most of VSAM resides in the pageable link pack area in the common area of 
virtual storage. Figure 1 illustrates VSAM’s relationship to OS/VS2, to the 
processing program, and to the data stored on a direct-access storage device 
and in mass storage. The subpools indicated in the figure (230, 231, 239, 241, 
245, 250, 252) contain VSAM control blocks. For more information see 
‘“Virtual-Storage Management” in “‘Diagnostic Aids.” 


VSAM is controlled by user macros. These macros are expanded into calling 
sequences to VSAM functions. For additional information on user macros, 
see OS/VS Virtual Storage Access Method (VSAM) Programmer’s Guide 
and OS/VS Access Method Services. 


VSAM communicates with other parts of the operating system through the 
SVC processor and through VS2 control blocks used by VSAM. In addition 
to the VS2 control blocks used by VSAM, VSAM builds and uses the 
access-method control block (ACB). The ACB describes a VSAM data set in 
much the same way that a DCB describes a nonVSAM data set. 


In addition to processing records and data sets, VSAM opens and closes data 
sets and does most of its own space management, that is, VSAM makes only 
minor use of VS2 Open and Close and relies on VS2 DADSM for only part of 
its space management. To do much of this work, VSAM uses the VS2 catalog. 
VS2 catalogs contain a description of VSAM space, where available space is, 
how space is used, and the location of data sets. For additional information on 
the catalog, see OS/VS2 Catalog Management Logic. 


VSAM is logically grouped into the following functional areas: 


e Data-Set Management (sometimes referred to in program documentation 
as “I/O Support’’), which comprises Open and Close for VSAM and for 
the ISAM Interface, Virtual-Storage Management, and BLDVRP/DLVRP 
processing 


— Open connects a user’s program to a VSAM data set and builds the 
control blocks required to permit the user to read from and write to the 
data set. 
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Figure 1. Relationship of VSAM, OS/VS2, User’s Processing Program, and Stored Data 





— Close disconnects a user’s program from a data set and releases the data 
set’s control blocks built by Open. Close also updates statistics in the 
catalog. 


— Virtual-Storage Management centralizes the processing of most requests 
for virtual storage. 


— BLDVRP/DLVRP processing builds and deletes VSAM resource pools 
for processing with local or global shared resources. (Processing with 
shared resources is described from the user’s point of view in OS/VS 

VSAM Options for Advanced Applications.) 


e Record Management, which comprises processing to satisfy user requests 
for access to data, including end-of-volume processing 


— Data-Request Processing requests I/O Management to read and write 
records in response to user-issued VSAM and ISAM macros (the latter 
by way of the ISAM Interface). It also requests I/O Management to 
read and write records for VS2 Catalog Management. 
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— End of Volume mounts volumes and allocates space. It modifies the 
existing control blocks to reflect the newly mounted volumes and newly 
allocated space. 


e Control Block Manipulation, which allows a user’s program to generate 
some control blocks (ACB, EXLST, and RPL) dynamically and to modify, 
display, and test their contents 


« I/O Management, which comprises the Problem-State I/O Driver, the 
Supervisor-State I/O Driver, the Actual Block Processor, end appendages, 
an asynchronous routine, and a purge routine 


— The drivers and the Actual Block Processor translate requests for access 
to the contents of control intervals to requests for reading and writing 
physical records. They build a channel program to give to the VS2 I/O 
Supervisor. 


— The appendages and the asynchronous routine get control back to the 
requester after I/O is finished. 
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METHOD OF OPERATION 


Method of operation diagrams are functional descriptions of VSAM. The 
diagram and descriptive notes, keyed to the diagram, are on facing pages. 


Reading Method of Operation Diagrams 


The diagrams contain three blocks of information: input, processing, and 
output. The left-hand side of the diagram shows the data that serves as input 
to the processing steps in the center of the diagram, and the right-hand side 
shows the data that is output from the processing steps. Input is anything a 
program function refers to or gets. Processing is the steps required to fulfill 
the function represented by the diagram. Output is any change effected by a 
function; for example, register contents, or control blocks created or 
modified. The processing steps are numbered; the numbers correspond to 
notes on the facing page. The notes include cross-references to the listings. 
Figure 2 shows a method of operation figure. 


The left-hand side of the diagram shows the input required by the function 
shown in the diagram. For example, register 1 points to a list of DCB pointers 
for an ISAM user. The SYS1.SYSJOBQE contains the JFCB, which indicates 
the data set’s organization. The data-set information in the DCB is input to 





Diagram ACI. VSAM OPEN: Connect a User to a VSAM Data Set 
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Figure 2. Method of Operation Diagram 
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steps 1 and 2 in the processing portion of the diagram. The DDNAME is 
input to step 2 in the processing portion of the diagram. 


The processing portion of the diagram shows the processing steps required to 
fulfill the function described by the diagram. Note that the function described 
by one diagram might be performed by one or more VSAM modules; that is, 
the diagrams describe functions, not physical parts of the program. 


The figure shows two conditions for which VSAM Open is called: (1) at step 
1 when processing is to be done for an ISAM user program and (2) at step 4 
when processing is to be done for a VSAM user program or for an ISAM user 
program that has been processed by steps 1 through 3. The numbers 1, 2, 3, 
4, and 5 are keys to the notes for this diagram. 


The output created by each processing step is shown in the diagram. Step 1, 
for example, builds a control block (the IICB); step 2 builds VSAM user 
control blocks (the ACB and EXLST). 


Reading the method of operation diagrams requires that you understand the 
symbols they use. Figure 3 shows the symbols and describes their meaning. 


> Flow of control on the same diagram; 
‘3’ indicates a number of a process 
9 step on the same diagram. 
Flow of control between diagrams; 
‘AA3’ is the diagram number and 


‘2’ is the number of a process step 
on that diagram. 


Pointers 


Reference to data or 
testing of data by a 

process step; ‘H’ is an 
arbitrary designation. 


Input to process steps 
and output from process 
steps; ‘A’ is an arbitrary 


---»® 

@)---> 
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Modification of data by 
Paes a process step; ‘P” is an 
arbitrary designation. 


(Pp eee: 


Figure 3. Graphic Symbols Used in Method of Operations Diagrams 
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Figure 4 shows part of the notes to Figure 3. 


The notes provide details about the processing shown in the diagram. For 
example, the entry process and conditions are described by the first 
(unnumbered) note. This note tells which OS/VS Open modules allow an 
ISAM user’s program to open an ACB for a VSAM data set; note 1 describes 
the use of the IICB and directs you to “Data Areas’’ in this publication for 
detailed information on the IICB. The notes also name the modules and 
routines that perform the functions represented. The module and procedure 
names allow you to relate a process step to a unit of code in the VSAM 


program listings. 


Notes for Diagram AC1 


When the caller issues the OPEN macro, SVC 19, 
IGCOOOII (VS2 Open) is entered by the VS2 SVC 
Interruption handler. 


VS2 Open obtains the JFCB from the scheduler work 
area. 


If the JFCB data-set organization (JFCDSORG) field 
indicates a VSAM data organization and the DCB 
data-set organization (DCBDSORG) indicates indexed 
sequential organization, IFG0193A (VS2 Open) sets the 
identifier for each DCB-for-VSAM-data-organization 
entry in the WTG table to ‘2I’, the identifier of the 
ISAM-Interface Open routine. 


1 IDAO192I: BLDIICB, INITIICB 


The IICB serves as a bridge between the ISAM user 
program’s DCB and the VSAM control blocks that 
allow the user’s program to read and write records. 


See “Data Areas” for details about the IICB. 
See OS/VS2 Data Areas for details about the DCB. 
2 IDAO0192I: BLDIICB, INITIICB, ACBMERGE 


The ISAM-Interface Open routine builds an ACB and 
an EXLST for each DCB for a VSAM data set being 
opened. The ACB is initialized with the DCB 
DDNAME and MACRF fields. 


See ‘Data Areas” for details about the ACB and 
EXLST. 


3 IDA0192I: OPENACB 


The ISAM-Interface Open routine builds an open 
parameter list and issues SVC 19 to open the ACB. 


VS2 Open copies the ACB from the user’s area into 
the Open work area. 


If the open-parameter-list entry addresses a VSAM 
ACB, VS2 Open sets the identifier field for each ACB 
entry in the WTG table to C‘2A’, the identifier of the 
VSAM Open routine. All further VS2 Open processing 
is bypassed for each ACB entry until the VSAM Open 
routine returns control to VS2 Open at step 57. 


VSAM Open Processing 
4 See Diagram AC2. 


§ See Diagram AC3. This step is skipped for a dummy 
data set. 


6 See Diagram AC4. The object could be an alternate 
index that is itself being opened for processing by the 
user. 





7 See Diagram ACS. This step is skipped for a dummy 
data set. 


8 See Diagram AC6. This step is skipped for a dummy 
data set. 


9 IDA0192A: BLDDDEB 


VSAM Open builds a ‘‘dummy DEB” for the user 
ACB and adds its address to the job step’s TCB DEB 
chain. (The device-dependent section of the DEB is set 
to 0.) Each open ACB is identified by adummy DEB 
in the chain. If the user’s program ends abnormally, 
ABEND closes the ACB or DCB associated with each 
DEB in the chain. 


10 See Diagram AC7. 
A Note about Dynamic String Addition 


When OPEN is issued, not to open a data set, but to 
dynamically add a string to the user's capability to process 
multiple requests concurrently, the string is added and 
Open returns to the caller. VSAM Record Management 
requests dynamic string addition when more strings are 
required than the user specified. 


Record Management indicates dynamic string addition by 
a flag in the ACB. 


IDA0192Y (ENQBUSY) issues ENQ on ‘SYSVSAM with 
‘B’ (busy) indicated to prevent Open from using the 
control block structure that is affected by dynamic string 
addition. 


IDA0192Y (INITPLH) builds and initializes an additional 
PLH, IOMB, IOSB, and PFL. IDA0192Y (BLDBUFC) 
builds and initializes an additional BUFC and buffer. 
IDA0192W builds an additional CPA and chains it to the 
BUFC. IDA0192Y (DYNSTRAD) chains these new 
control blocks into the existing control block structure. 
(PLHDR points to the PLH, and BUFDR points to the 
BUFC.) 


Figure 4. Notes to Method of Operation Diagram 
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PROGRAM ORGANIZATION 


Module Prologues 


VSAM program listings contain the details of VSAM’s documentation. You 
get into the listings from the method of operation diagrams. 


Once you have located the module or routine name that interests you in the 
diagrams, you are ready to turn to the listing to find the additional 
information you require. 


Each VSAM module listing begins with a description of the module, called the 
module prologue. 


The information contained in VSAM module prologues is described in the 
topics that follow. 


Module name: The external procedure name of the module (for example, 
IFGO192A). 


Descriptive name: The English name of the module (for example, VSAM 
Open). 


Status: The version and release level of the module. 


Function: A brief step-by-step explanation of the functions performed by this 
module. Function is divided into steps so that you may more easily locate the 
routine responsible for each step. 


Notes: A generalized heading that includes (1) any dependencies, for 
example, CPU model or features, that will affect the operation of this module, 
(2) any restrictions that apply to this module, (3) symbols used to represent 
registers and register usage, (4) symbolic name of the maintenance area for 
this module and whether the maintenance area is used or reserved, and (5) 
any special terms and acronyms that are used within this module that are not 
necessarily used elsewhere in the documentation. 


Module type: A description of the type of this module (for example, 
procedure or macro), the name of the compiler used/required to create this 
module, the amount of storage required by this module for executable code 
and associated data, and the attributes of the module (for example, reentrant 
or read-only). 


Entry point: The name of the point at which control can enter this module, 
the conditions of entry, the calling sequence by which control was given, 
including any parameters passed and the names of modules that may enter at 
this entry point. 


Input: A description of anything this module gets or references, for example, 
registers, control blocks, and data. The means by which this module gains 
access to the input is included. 


Output: A description of registers, control blocks, and data areas at output; 
any messages issued as a result of this module’s processing are included. 


Exit-normal: A description of conditions at and reasons for normal exit from 
this module, including the names of modules called by this module. 


Exit-error: A description of conditions at and reasons for any error exit from 
this module. 
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External references: A list of modules, data areas, etc., defined outside of or 
accessible outside of this module. 


Tables: A list of all local tables and work areas, that is, data areas built and 
used only within this module. 


Macros: A description of system macros used by this module. 


Change activity: A list of any change activity to this module. 


Module Flow Compendiums 


Reading Program Organization Compendiums 


Program organization compendiums are descriptions of VSAM functions, in 
terms of module (procedure) calls and usage. The compendium and 
descriptive notes, keyed to the compendium, are on the same page whenever 
possible, or on facing pages. 


The compendium shows the flow of control between VSAM modules in order 
to perform a VSAM function. Figure 5 shows a compendium figure. A 
single-headed arrow (between IGCOO0O01I and IFG0193A) indicates that 
control is passed from one module to another and does not return. A 
double-headed arrow indicates that control is returned when the “‘called”’ 
module completes its processing. 


Blocks that are indented (otherwise contained within another block) are 
called to perform a specified function and return, when finished, to the caller. 


OPEN 


SVC 19 IGCOOOII 


1 IFGO193A 


IFGO192A 
Parameter 2 IDAO192A* 


List 
3 IDA0192C 


4 IDA0192F* 









5 IDA0192V 


6 [DA0192D 
7 [IDA0192C 


Figure 5. Program Organization Compendium Figure 
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C 


a 


For example, IDA0192A calls IDA0192C to retrieve information from the 


catalog. 


Numbers and letters in bold-face type refer to descriptive notes. The notes 
tell what the caller expects the called module (procedure) to do. 


Data-Set Management Compendiums 





OPEN CLOSE 







Figure 7 Figure 9 
Open a VSAM Open a VS2 
Cluster (from Catalog (from 
an ISAM-User’s the VS2 
Program) Scheduler) 


Figure 11 


Program) 


Figure 8 

Open a VSAM Figure 10 
Cluster (from Add a String 
a VSAM-User’s Dynamically 
Program) 





CLOSE (TYPE = T) Verify Data Space 


Figure 15 
Figure 14 Verify a NonVSAM 
Temporary Close Caller’s Authorization 
(TYPE=T) of to Process Each Data 
a VSAM Cluster Set ina VSAM 

Data Space 


Close a VSAM 
Cluster (from 
an ISAM-User’s 



















Figure 13 
Close a VS2 
Catalog (from 
the VS2 
Scheduler) 








Figure 12 
Close a VSAM 
Cluster (from 

a VSAM-User’s 
Program) 


BLDVRP/DLVRP 


Figure 16 
Build or 
Delete a 
VSAM 
Resource Pool 





Checkpoint Restart 


Figure 18 
Restart 


Figure 17 


Checkpoint 


Processing Processing 





Figure 6. Data Set Management Program Organization Contents 





Program Organization 193 

















OPEN 
SVC 19 IGCO001! 
R] 1 IFGO196V 
3 IDA0192I 
e Issues SVC 19 
Open 
Parameter 
List See Figure 8 
Return 
to IFGO198N 
Caller 


Figure 7. Open a VSAM Cluster (from an ISAM-User’s Program) 
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Notes for Figure 7 


1 IGCO0001I, IFGO196V, and IFGO198N are VS2 Open 
modules (see OS/VS2 Open/Close/EOV Logic for 
details). 


2 IFG0192I is an alias-name for IFGO192A. 


IDA0192I is the ISAM-Interface: Open module. It is an 
alias for IDAO192A. 
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OPEN 
Sen IGCOO011 
@) 1 IFGO193A 


Rl 



















Open 
Parameter 
List 


2 IDA0192A* 


3 IDA0192C 


4 IDA0192F* 






§ IDA0192V 


6 IDA0192D 
7 IDA0192C 


8 IDA0192B 


9 IDA0192C 


10 IDA0192Z* 










11 IDA0192Y* 
12 IDA0192W* 


13 IDA0192D 
14 IDA0192P 


15 IDA0192P 


16 IDA0192P 
17 IDA01928 


18 VS2 1/0 
Support 
Recovery 
Routine 


19 IDAOCEA1 


20 VS2 Task 
Close 


21 IDAOCEA2 











Return 
to IFGO198N 
Caller 


Note: * indicates that the module calls IDA0192M for virtual storage. 
IDA0192M is the VSAM Virtual-Storage Manager. 


Figure 8. Open a VSAM Cluster (from a VSAM-User's Program) 
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Notes for Figure 8 


10 


11 


12 
13 


14 


15 
16 
17 


IGCO0001I, IFG0193A, and IFGO198N are VS2 Open 
modules (see OS/VS2 Open/Close/EOV Logic for 
details). 


IFGO0191Y (in Figure 9) XCTLs to IFG0193A to open a 
VS2 catalog. Open-processing and return-to-the-caller 
continues as shown in this figure. 


IDA0192A is the VSAM Open module. It builds the BIB, 
WSHD, and dummy DEB. 


IDA0192C calls VS2 Catalog Management (LOCATE) to 
retrieve information about the VSAM object being opened 
from its catalog record. 


IDAO0192F opens base, path, and upgrade clusters. It 
builds the ACB, AMBL, CMB, UPT, VAT, and VMT. 


IDA0192V ensures that the required minimum number of 
the object’s direct-access volumes are mounted. 


If the data set is stored on a mass storage volume, 
IDA0192D stages (via a Mass Storage System ACQUIRE) 
the data set to a direct-access storage device. 


IDA0192C checks the time stamp. 
IDA0192B opens VSAM clusters. 


IDA0192C calls VS2 Catalog Management (LOCATE) to 
retrieve volume serial numbers from the object’s catalog 
record. 


IDA0192Z builds the following control blocks: 
AMB DEB IWA 
AMBXN EDB’~ LPMB 
AMDSB_—esIQE 
ARDB IRB 
IDAO0192Y builds the: 
BUFC IOSB SRB 
Buffers PLH WAX 
IOMB RPL 
IDA0192W builds the CPA control block. 


If the data set is stored on a mass storage volume, 
IDA0192D stages (via a Mass Storage System 
ACQUIRE) the data set to a direct-access storage 
device. 


Whenever a VSAM Open module detects an error, 
IDA0192P issues a diagnostic message and traces 
VSAM control blocks if the Generalized Trace Facility 
(GTF) is active. 


Same as step 14. 
Same as step 14. 
IDA0192S writes SMF record type 62. 


18-19 


IDAOCEAI runs as an ESTAE exit routine when an 
error occurs in Open. It logs system information and 
returns to the VS2 I/O Support Recovery Routine to 
continue with termination. 


20-21 


IDAOCEA2Z locates and frees storage used for VSAM 
data sets in the system queue area and the common 


service area. 
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OPEN 


SVC 19 1 IGCO001I 


IFG0O191X 


2 IFGO191Y 


See Figure 8 (A) 


tCatalog’s 
ACB 





Figure 9. Open a VS2 Catalog (from the VS2 Scheduler) 
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Notes for Figure 9 
1 IGCOOOII is a VS2 Open module. 


| 2 IFGO191X and IFG0191Y are VS2 Catalog Open: ACB 
‘ Processing modules. These modules perform special 
processing for the catalog’s ACB, then transfer control 
(using the XCTL macro) to IFG0193A (in Figure 8). 
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BLDVRP/DLVRP 
SVC 19 


3 IDA0192Y 









4 IDA0192M 


5 [DA0192W 
6 IDA0192M 


Return 
to 
Caller 


7 VS2 Recovery 
Termination 
Manager 







8 IDAOCEA4 


SIDAOCEAI 


Figure 10. Add a String Dynamically 
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C 


Notes for Figure 10 
1 IGCOOO01I determines whether SVC 19 was issued for a 


VSAM ACB (subtype X‘11’). It obtains a pseudo 
FORCORE: base prefix, extended prefix, WIG, RPL, and 
work area. The visual ID is *VRP.’ 


IFG0192Y is the second entry point in csect IFG0O192A in 
load module IFGO192A. It: 


¢ Sets audit-trail information in FORCORE 


e Ensures that the key of the parameter list is the caller’s 
key, which IFG0192Y uses for processing 


e Establishes DX VKEY, DXUDCBAD, and DXPDCBAB 


e Moves the BLDVRP parameter list (which appears to be 
an ACB with subtype X‘11’) to protected storage 


¢ Establishes ESTAE (IDAOCEA4) in case an error 
occurs in subsequent processing 


When IFG0192Y receives control back from IDA0192Y, 
it: 


¢ Cancels the ESTAE 
« Frees the pseudo FORCORE (with IECRES macro) 


IDA0192Y builds conrol blocks to add a string for Record 
Management processing. It: 


¢« Enqueues busy on the data set to prevent concurrent 
Data-Set Management requests (OPEN, CLOSE, 
CLOSE(TYPE=T)) 


¢ Builds string blocks for the data AMB: BUFC, 
PLH/IOMBXN, IOMB/IQE, SRB/IOSB/PFL, CPA 
(and, for a path, RPL/WAX) 


e For a key-sequenced data set, builds string blocks for the 
index AMB: BUFC, CPA 


e Adjusts the string count in the CMB for the data set 
¢ Chains string blocks (with swap/save) 


IDA0192M allocates virtual storage for IDA0192Y to use 
to build control blocks. 


IDA0192W builds required channel programs and CPAs. 
Same as step 4. 


The VS2 Recovery Termination Manager gets control 
when an error occurs in VS2. 


IDAOCEAG is the BLDVRP/DLVRP ESTAE routine. 


IDAOCEATl is the Data-Set Management Recovery 
Routine for error recording. 
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CLOSE 
SVC 20 1GC00020 ) 


1 IFGO200V 













3 IDA0200S 
@ Issues SVC 20 


See Figure 12 


4 VS21/0 
Support 
Recovery 
Routine 


5 IDAOQCEA1 


Close 
Parameter 
List 





6 IDAICIA1 


Return 
to IFGO202L 


Caller 
Figure 11. Close a VSAM Cluster (from an ISAM-User’s Program) 
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C 


Notes for Figure 11 


1 


IGC00020, IFGO200V, and IFG0202L are VS2 Close 
modules (see OS/VS2 Open/Close/EOV Logic for 
details). 


IFG0200S is an alias-name for IFGO192A. 


IDA0200S is the ISAM-Interface Close module. It is an 
alias for IDA0192A. 


The VS2 I/O Support Recovery Routine is an ESTAE 
routine. IDAOCEAl| is the VSAM ESTAE routine, and 
IDAICIA1 is the ISAM-Interface ESTAE routine. 
IDAICIAI1 frees ISAM-Interface work areas and records 
information in SYS1.DUMP or the SYSABEND data 
set. 
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CLOSE 
SVC 20 IGC00020 
1 IFGO200V 






3 IDAO200T 


4 IDAOI9SRI1 


$ IDA0200B 


6 IDAO192Y 


7 IDAO192C 
e Issues SVC 26 


See OS/VS2 
Catalog 
Management 
Logic 




















8 IDA0192S 
9 IDA0192D 
10 IDA0192P 


11 IDA0192C 
12 {DA0192P 


13 VS2 1/0 
Support 
Recovery Routine 


14 IDAOCEAL 











1§ VS2 
Task Close 


16 IDAOCEA2 


IFGO202L 


Figure 12. Close a VSAM Cluster (from a VSAM-User’s Program) 
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Notes for Figure 12 


1 IGC00020, IFGO200V, and IFG0202L are VS2 Close 
modules (see OS/VS2 Open/Close/EOV Logic for 
details). 


A IFGO200N (in Figure 13) XCTLs to IFG0200V to close a 
VS2 catalog or catalog recovery area. Close-processing 
and return-to-the-caller continues as shown in this figure. 


IFG0200T is an alias-name for IFG0O192A. 


IDA0200T is the VSAM Close module. It frees control 
blocks. 


4 Foran output data set, IDA0200T issues an ENDREQ 
macro for VSAM to write out buffers and finish I/O for 
the data set. (See Figure 31.) 


IDA0200B closes VSAM clusters. 


IDA0192Y builds control blocks for the WRTBFR macro, 
when Record Management indicates they are needed. The 
storage obtained for the control blocks is freed by Close. 


7 IDAO192C calls VS2 Catalog Management (UPDATE) to 
modify statistical information in the object’s catalog 
record. 


IDA0192S writes SMF record(s) type 64. 


If the data set is stored on a mass storage volume, 
IDA0192D destages (via a Mass Storage System 
RELINQUISH) the data set from direct-access storage to 
mass storage. 


10 Whenever IDA0200B detects an error, IDA0192P issues a 
diagnostic message. 


11 When a catalog is being closed, IDA0192C calls VS2 
Catalog Management (LOCATE) to indicate that Close 
has finished. 


12 IDA0192P issues a diagnostic message whenever 
IDAO0200T detects an error. 


13-14 
IDAOCEAI runs as an ESTAE exit when an error occurs 
in Open. It logs system information and returns to the VS2 
I/O Support Revovery Routine to continue with 
termination. 


15-16 
IDAOCEA2 locates and frees storage used for VSAM 
data sets in the system queue area and the common 
service area. 
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Figure 13. Close a VS2 Catalog (from the VS2 Scheduler) 
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See Figure 12@ 





Notes for Figure 13 


1 1GC00020 is a VS2 Close module (see OS/VS2 
( Open/Close/EOV Logic for details). 


2 IFGO200N is the VS2 Catalog Close: ACB Processing 
module. It performs special processing for the catalog’s 
ACB, then XCTLs to IFGO200V (in Figure 12). 
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Figure 14. Temporary Close (TYPE=T) of a VSAM Cluster 
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Notes for Figure 14 


1 


9 


IGC0002C and IFG0232Z are VS2 temporary-Close 
modules (see OS/VS2 Open/Close/EOV Logic for 
details). 


IFG0231T is an alias-name for IFGO192A. 
IDA0231T is the VSAM temporary-Close module. 


For an output data set, IDA0231T issues an ENDREQ 
macro for VSAM to write out buffers and finish I/O for 
the data set. (See Figure 31.) 


IDA0231B is the VSAM Close (TYPE=T) module for 
closing clusters. 


IDA0192Y builds control blocks for the WRTBFR macro, 
when Record Management indicates they are needed. The 
storage obtained for the control blocks is freed by Close. 


If the data set is stored on a mass storage volume and is 
defined with the DESTAGEWAIT attribute, IDA0192D 
destages (via a Mass Storage System RELINQUISH) the 
data set from direct-access storage to mass storage and 
waits until destaging is completed. If the data set was not 
bound in direct-access storage, IDA0192D restages (via a 
Mass Storage System ACQUIRE) the data set from mass 
storage to direct-access storage. 


IDA0192C calls VS2 Catalog Management (UPDATE) to 
modify statistical information in the object's catalog 
record. 


IDA0192S writes SMF record(s) type 64. 


10 Whenever IDA0231B detects an error, IDA0192P issues a 


diagnostic message. 


11 IDA0192P issues a diagnostic message whenever 


IDA0231T detects an error. 
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Figure 15. Verify a NonVSAM Caller’s Authorization to Process Each Data Set ina VSAM Data Space 
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Notes for Figure 15 


Note: The VIOC contains a format-1 (identifier) DSCB to 
describe each VSAM data space. The DSCB indicates that 
the space it describes is protected and that the caller must 
provide the correct password before access is granted. 


When a VSAM data space is shared (nonunique), the caller 
must provide the correct master password for each data set in 
the data space before he is allowed to process the data space. 


1 When the caller is the VS2 DADSM Scratch Routine and 
the format-1 DSCB identifies a VSAM data space, 
SECLOADA passes control to IDA0192G. (See OS/VS2 
Open/Close/EOV Logic for SECLOADA details.) 


2 When the caller is authorized (is in key 0 and supervisor 
state), IDA0192G does no further checking. 


3 When a utility program issues OPEN, CLOSE, or the SVC 
for End of Volume, IFG0O195T determines that the caller 
is other than VSAM or ISAM Interface and that the 
format-1 DSCB is protected. (See OS/VS2 
Open/Close/EOV Logic for details.) 


4 IDAO0192G verifies the caller’s authorization to process the 
data space. 


5 IDA0192C issues SVC 26 (GENDSP) to VS2 Catalog 
Management to obtain the DSNAME of each VSAM data 
set in the data space. 


6 IDA0192C issues SVC 26 (LOCATE) to cause VS2 
Catalog Management to verify that the caller can supply 
each protected data set’s master password. 
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Figure 16. Build or Delete a VSAM Resource Pool 
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C 


Notes for Figure 16 


1 


IGC0001I determines whether SVC 19 was issued for a 
VSAM ACB (subtype X‘11’) and determines whether SVC 
19 is for BLDVRP or DLVRP. It obtains a pseudo 
FORCORE: base prefix, extended prefix, WT'G, RPL, and 
work area. The visual ID is “VRP’ 


IFGO0192Y is the second entry point in csect IFG0O192A in 
load module IFGO192A. It: 


e Sets audit-trail information in FORCORE 


e Ensures that the key of the parameter list is the caller’s 
key, which IFG0192Y uses for processing 


e Establishes DXVKEY, DKUDCBAD, and DXPDCBAB 


« Moves the BLDVRP parameter list (which appears to be 
an ACB with subtype X‘11’) to protected storage 


e Establishes ESTAE (IDAOCEA4) in case an error 
occurs in subsequent processing 


When IFG0192Y receives control back from IDA0192Y, 
it: 


e Cancels the ESTAE 
« Frees the pseudo FORCORE (with IECRES macro) 


IDA0192Y does validity checking and builds or deletes 
control blocks for a VSAM global (GSR) or local (LSR) 
resource pool: VSRT, WSHD, CPA header, PLHs, BSPH, 
BUFCs, buffers. For BLDVRP, it chains the VSRT to the 
VAT; for DLVRP, it unchains it. It uses a pseudo 
FORCORE, an ACB work area (IDAOPWRK), and a 
copy of the BLDVRP parameter list in protected storage. 


IDA0192M allocates virtual storage for IDA0192Y to use 
to build control blocks. 


The VS2 Recovery Termination Manager gets control 
when an error occurs in VS2. 


IDAOCEAG4 is the BLDVRP/DLVRP ESTAE routine. 


IDAOCEAL is the Data-Set Management Recovery 
Routine for error recording. 


Program Organization 213 





CHKPT ' 
SVC 63 IGCO006C 







> IDAOCO6C 
7 
IDACI96C 








8 IDAOI96EC 


9 IDACKRAI 


Return 
peCaie 4 1GCOS06C 


Figure 17. Checkpoint Processing 
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Notes for Figure 17 


1-4 IGC0006C, IGC0206C, IGCONO6C, and IGCOSO6C are 
VS2 checkpoint modules described in OS/VS2 
Checkpoint/Restart Logic. 


5 IDAOCO6C is the VSAM checkpoint module. It saves 
information required by restart in VCRCORE. 


6 IDACKRAL is the VSAM checkpoint/restart ESTAE 
routine. It provides problem determination information 
and attempts to pass control to a retry routine. 


7 ‘If any errors occur during checkpoint processing, 
IDACI96C frees all VCRCORE. 


8 If a valid JSCBSHR field exists, IDA0196C builds an 
SSCR. If any VCRCORE exists, it is freed. 


9 Same as step 6. 
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Figure 18. Restart Processing 





216 OS/VS2 Virtual Storage Access Method (VSAM) Logic 


Notes for Figure 18 


1 IGCO005B and IGCONOS5B are VS2 restart modules 
described in OS/VS2 Checkpoint/Restart Logic. 


2 IDAOCOSB is the VSAM restart SSCR and DEB module. 
It restores the JSCBSHR, frees AMB DEBs, and sets 
DEBXCDCB to mark VSAM ACBs noncloseable. 


3 IDACKRAI formats a message in the SDWA, executes 
the SDUMP macro, and either returns to a retry routine 
or continues with abnormal termination. 


4 IGCOTOSB is a VS2 restart module described in OS/VS2 
Checkpoint/Restart Logic. 


5 IDAOAOSB is the VSAM restart module. It rebuilds 
VGTTs and HEBs and does repositioning and verify 
processing. 


6 IDA0192C obtains the relatonships to the cluster being 
restarted. 


IDA0192F builds the VMTs for the sphere. 


For each VCRT processed, IDA0192V ensures that the 
required number of the cluster’s direct-access volumes are 
mounted. 


9 If the data set is stored on a mass storage volume, 
IDA0192D stages (via a Mass Storage System ACQUIRE) 
the data set to a direct-access storage device. 


10 IDA0192C checks the time stamp. 


11 IDA0192B performs volume processing for each AMB in 
the cluster and does share processing for the cluster. 


12 IDA0192C calls VS2 Catalog Management (LOCATE) to 
retrieve volume serial numbers from the cluster’s catalog 
records. 


13 IDA0192Z refreshes AMDSBs and ARDBs and rebuilds 
DEBs and EDBs. 


14 IDA0192Y rebuilds SRBs, IOSBs, and PFLs. 


15 If the data set is stored on a mass storage volume, 
IDA0192D stages (via a Mass Storage System ACQUIRE) 
the data set to a direct-access storage device. 


16 Whenever a VSAM Open module detects an error, 
IDA0192P issues a diagnostic message and traces VSAM 
control blocks if the Generalized Trace Facility (GTF) is 
active. 


17 IDACI96C is an external entry for IDA0196C and 
performs cleanup functions for VSAM 
Checkpoint/Restart control blocks. 


18 Same as step 3. 


19 IGCOVOSB is a VS2 restart module described in OS/VS2 
Checkpoint/Restart Logic. 
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Figure 20. GET: Direct and Skip Sequential Processing (ESDS, KSDS) 
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Notes for Figure 20 


1 


IDAO19R1 is the common Record Management request 
module. It verifies that the request is a valid 
Record-Management macro, then tests the RPL for keyed 
or addressed processing. 


When the request requires either keyed or addressed 
processing (not a control-interval-processing request), 
IDAO19R4 selects the correct processing path for either 
GET, PUT, or POINT, and for sequential, skip sequential, 
or direct processing. 


When the request is either direct GET or skip sequential 
GET, IDA019RA locates the position of the desired data 
record in its control interval. 


DATARTV makes an unspanned data record available to 
the caller. It sets the RBA of the data record into the RPL. 
If the caller's request is in locate mode, DATARTV 
returns a pointer to the record to the caller. If the request 
is in move mode, DATARTV moves the data record into 
the caller's record area. 


IDADARTV moves all of the segments of a spanned 
record into the user’s area. 


IDAFREEB frees the buffer. 
IDAGNXT moves the next segment into a buffer. 


If the request is direct GET and the caller doesn’t want to 
retain the record’s position for subsequent record 
processing requests, RLSEBUFS releases the data record’s 
buffer. 


If the buffer was changed by a previous update request, 
IDAWRBER rewrites the buffer’s control interval into the 
data set. 


10 See Figure 40. 
11 IDAFREEB frees the data buffer. 
12 If the request is keyed, IDAFREEB frees the buffer 


containing the sequence set control interval associated 
with the data buffer. 


13 If the user’s EXLST contains an active journal exit 


address, IDATJXIT provides the necessary journaling 
information for the user's journal exit routine. 
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Figure 21. GET: Sequential Processing (ESDS, KSDS) 
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Notes for Figure 21 


1 IDAO19R1 is the common Record-Management request 
module. It verifies that the request is a valid 
Record-Management macro, then tests the RPL for keyed 
or addressed processing. 


2 When the request requires either keyed or addressed 
processing (not a control-interval-processing request), 
IDA019R4 selects the correct processing path for either 
GET, PUT, or POINT, and for sequential, skip sequential, 
or direct processing. 


3 When the request is sequential GET, PLHEXP tests the 
status indicators in the placeholder (PLH) to determine if 
an exceptional condition occurred: 


e If the request is the first request after the data set is 
opened, and isn’t preceded by a POINT to position to a 
starting record: 


4 If the request is addressed, IDAGRB reads in the first 
data control interval of the data set. 


5 If the request is keyed, IDAGRB reads in the first 
sequence set control interval. 


6 The sequence set control interval is used to determine 
the RBA of the first data control interval. IDAGRB 
retrieves the first data control interval of the 
key-sequenced data set. 


7 If the first control interval of the key-sequenced data 
set is empty, IDAFREEB frees its buffer. 


8 IDAGNXT obtains the next control interval of the 
key-sequenced data set. Steps 7 and 8 are repeated as 
often as necessary to obtain a nonempty control 
interval of the key-sequenced data set. 


e If the end of data condition occurs, PLHEXP sets a 
return code and returns to the caller. 


e If a read error occurs, ADVPLH skips over the bad data, 
resets the PLH so that it points to the next good data 
control interval’s RBA, and returns to the caller with a 
return code set. 


e If the previous request encountered a read-exclusive 
error (not allowed to read the record because another 
user has exclusive control over it), SCANDATA 
searches the index to locate the requested record. 


9 If no exceptional conditions have been detected, the PLH 
now points to the record most recently processed by the 
user. ADVPLH adjusts the PLH so that it points to the 
next record (desired by this request) in the buffer. 


10 If there are no more records in the buffer (that is, the 
record most recently processed by the user is the control 
interval’s last record), IDAFREEB frees the buffer. 


11 IDAGNXT retrieves the next sequential control interval, 


unless another buffer already contains the control interval. 


The PLH is set to point to the first data record in the 
control interval. 


12 If no exceptional conditions have been detected, the PLH 
now points to the record most recently processed by the 
user. IDAADVPH adjusts the PLH to point to the 
previous record (desired by this request) in the buffer. 


13 If there are no more records in the buffer (that is, the 
record last processed by the user is the control interval’s 
first record), IDAFREEB frees the buffer. 


14 IDAGNXT retrieves the next control interval in 
descending sequence, unless another buffer already 
contains the control interval. The PLH is set to point to 
the last record in the control interval. 


15 If the current request is GET-for-update, but the record’s 
buffer is not under the caller’s exclusive control, 
SCANDATA locates the record again to ensure that the 
PLH now points to it, even though updates might have 
occurred against it. The buffer is now under the caller’s 
exclusive control. 


16 IDAO19RA searches the index, if the data set is 
key-sequenced, or uses the caller-supplied RBA, if the data 
set is entry-sequenced, to determine the record’s location 
in the buffer. 


17 If the placeholder needs to be updated, ADVPLH updates 
it after the record has been located. 


18 DATARTV makes an unspanned data record available to 
the caller. It sets the RBA of the data record into the RPL. 
If the caller's request is in locate mode, DATARTV 
returns a pointer to the record in the caller's RPL. If the 
request is in move mode, DATARTV moves the data 
record into the caller’s record area. 


19 MOVEKEY saves the record’s key in the placeholder. 


20 If the user's EXLST contains an active journal exit 
address, IDATJXIT provides the necessary journaling 
information for the user’s journal exit routine. 


21 IDADARTV moves all the segments of a spanned record 
into the user’s area. 


22 IDAFREEB frees the buffer. 
23 IDAGNXT moves the next segment into a buffer. 
24 See the note for step 20. 


Program Organization 223 





IDAOL9R4 





1 IDAOI9RA 






2 IDAOLORZ 
IDAWAIT 






3 IDAO19RB 






4 IDA019RZ 
IDAGRB 








§ IDAM19R3 
(See Figure 40) 


6 IDA0N19RC 


7 IDAOI9RZ 
IDAFREEB 


8 IDA019RZ 
IDAFREEB 


9 IDA0NI9RW 
IDAFRBA 






10 IDA019RZ 
IDASBF 






11 IDAO19RZ 
IDAGRB 
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Notes for Figure 22 


1 


IDAO019RA locates the position of a desired data record in 
a control interval that is ina VSAM Record-Management 
buffer. 


If the control interval is being updated by another user, 
IDAWAIT waits until the updating is complete. 


If the data set is key-sequenced, IDA019RB searches the 
index to find the RBA of the desired data record’s control 
interval. 


IDAGRB obtains an index record to search. 
See Figure 40. 


IDAO19RC searches the index control interval to locate an 
index entry containing a key value equal to or greater than 
the search argument passed by IDA019RB. IDA019RC 
sets a return code to indicate the status of the search, and 
a pointer to the requested entry, if found. 


If IDAO19RC hasn’t found the termination point for the 
search (determined by IDA019RB), IDAFREEB releases 
the buffer containing the just-searched index control 
interval. 4 through 7 repeat until the termination point for 
the search is reached. 


If the placeholder doesn’t point to the buffer containing 
the desired data record, IDAFREEB frees the buffer 
currently pointed to by the PLH. 


IDAFRBA determine the RBA of the next sequential (or, 
if the request is keyed, the next higher keyed) control 
interval. 


10 IDASBF releases all buffers (except one) pointed to by the 


placeholder—buffers that have been assigned to the 
placeholder and available for its use, but are not currently 
in use. 


11 IDAGRB retrieves the data record’s control interval, 


located by the previous index search if the data set is 
key-sequenced or by the caller-specified RBA value if the 
data set is entry-sequenced. 


Program Organization 225 










1 IDAOI9RI 





2 IDAOISRR 
Direct or Skip 


Sequential 


3 IDAO19RR 
IDARRDRL 


4 IDAOI9RZ 
IDAGRB 


Sequential 














5 IDAOI9RR 
PLHEXP 






6 IDAODIIRZ 
IDAABF 


7 IDAOI9RZ 
IDAGRB 
8 IDAOIIRR 
ADVCI 


9 IDA019RZ 
IDAFREEB 
10 IDA019RZ 
IDAGNXT 


11 IDAO19RR 
ADVPLH 









12 IDAO19RR 
ADVCI 


13 IDAOLORZ 
IDAFREEB 

14 IDAOLORZ 
IDAGNXT 


15 IDAOI9RR 
GETXCTL 


16 IDAOLORR 
IDARRDRL 








Figure 23. GET Processing (RRDS) 
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Notes for Figure 23 


1 IDAO19R1 is the common Record Management request 
module. It verifies that the request is valid and checks for 
keyed processing of a relative record data set. 


2 IDAOI19RR selects the processing path for GET, PUT, 
POINT, or ERASE and for direct, sequential, or skip 
sequential access. 


Direct or Skip Sequential 


The search argument (relative record number) is converted to 
the RBA of the control interval that contains it and the offset 
of the record in the control interval. 


3. For skip sequential access, IDARRDRL verifies that the 
search argument is greater than the previous one, 
indicated by positioning. 


4 IDAGRB retrieves the control interval by RBA, and 
IDARRDRL sets the PLH pointer to the record. 


Sequential 


5 For sequential retrieval, positioning must have been 
established. Status indicators in the PLH indicate any 
exceptional condition, which is handled by PLHEXP: 


« For the first request after OPEN, positioning is implicitly 
established at the beginning or the end of the data set 
(depending on whether processing is to be forward or 
backward). Steps 6 through 10 handle this exceptional 
condition. 


e If the end of the data set (or the beginning, for backward 
processing) has already been reached, PLHEXP sets an 
error code and returns to the caller. 


e If there has been a read error, PLHEXP calls ADVPLH, 
which skips over the unreadable control interval, 
searches for the next slot that contains a record, and sets 
the PLH pointer to the record. 


« If the control interval couldn’t be retrieved before 
because another request had exclusive control of it, 
PLHEXP calls GETXCTL to retrieve the control 
interval. 


6 IDAABF adds buffers to the buffer chain for read-ahead 
buffering. 


7 IDAGRB retrieves the first control interval and scans it 
for the first slot that contains a record. 


8 If the control interval doesn’t contain a record, ADVCI 
advances to the next control interval, and the next, until it 
finds a slot that contains a record. 


9 IDAFREEB frees the current data buffer. 
10 IDAGNXT retrieves the next sequential control interval. 


11 For processing when there is no exceptional condition, 
ADVPLH advances to the next slot that contains a record 
and sets the PLH pointer to the record. 


12 ADVCI advances to the next slot that contains a record. 
13 IDAFREEB frees the current data buffer. 
14 IDAGNXT retrieves the next sequential control interval. 


15 For GET-update, when the buffer isn’t already under 
exclusive control, GETXCTL retrieves the control interval 
with exclusive control of the buffer that contains it. 





16 IDARRDRL retrieves the control interval by RBA and 
sets the PLH pointer to the first slot that contains a 
record. 


Common Tenmnination 


17 COMGET sets RPL fields for the user, updates statistics, 
and releases positioning, if necessary. 


18 For a direct request that is not for update, not to have 
string position noted, and not in locate mode, IDAFREEB 
frees the current data buffer. 


19 If the user’s EXLST contains an active journal exit 
address, IDATJXIT provides the necessary journaling 
information for the user’s journal exit routine. 
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Notes for Figure 24 


1 IDAO019R1 is the common Record-Management request 
module. It verifies that the request is a valid 
Record-Management macro, then tests the RPL for keyed 
or addressed processing. 


2 When the request requires either keyed or addressed 
processing (not a control-interval-processing request), 
IDAO19R4 selects the correct processing path for either 
GET, PUT, or POINT, and for sequential, skip sequential, 
or direct processing. 


3 When the request is PUT-Update, IDA019R4 verifies that 
the previous request was a.GET-for-update. 


4 When the record is added sequentially to a key-sequenced 
data set, SQICHECK ensures that the new record's key is 
in the correct sequence. 


5 If the caller's previous request didn’t establish a position in 
the data set, or if the key of the record to be inserted is 
greater than the key for the current position, IDAO1I9RA 
searches the index to find the correct position for the new 
record to be inserted. IDAO19RA returns a pointer to the 
insertion point for the record in the buffer. This process 
occurs only after the data set has been created. 


6 When the first record of a data set is being written, 
IDAGNNEFL obtains an empty buffer to build the control 
interval’s records in. This process occurs only when the 
data set is being created. 


7 When the request is a direct or skip-sequential insert into 
an entry-sequenced data set, GETINCI ensures that the 
last control interval that contains data records is available 
to receive the new data record. 


8 IDAQOI19RA locates the correct control interval and reads it 
into a buffer (if the request is direct). 


9 When the request is either PUT-Update or ERASE, 
IDAOI9RL either replaces the old record’s contents with 
updated information (PUT-Update) or removes the old 
record from the data control interval. 


When the request is a direct or skip-sequential insert into a 
key-sequenced data set, IDA0O19RA searches the index to 
locate the correct sequence set and data control interval, 
and reads both control intervals into buffers. 


10 IDA019RM inserts the record into the buffer at a 
previously determined insertion point. IDA019RM builds 
the record’s RDF and inserts the record into the control 
interval, adjusting other records as necessary. 


11 If the request is direct PUT and the caller doesn’t want to 
retain the record’s position for subsequent record 
processing requests, RLSEBUFS releases the data record’s 
buffer. 


12 If the buffer was changed by a previous update request, 
IDAWRBER rewrites the buffer’s control interval into the 
data set. 


13 IDAFREEB frees the buffer currently pointed to by the 
PLH. 


14 If the user's EXLST contains an active journal exit 
address, IDATJXIT provides the necessary journaling 
information for the user’s journal exit routine. 


15 IDA019RM calls IDA019RT for spanned-record insertion. 
16 See note for step 15. 


17 If the current buffer isn’t empty, IDAO19RE is called to 
split the control interval. 


18 If the control area hasn’t enough free space for the 
spanned record, IDAO019RF is called to split the control 
area. 


19 IDAO19RC finds the position of the current entry in the 
sequence set. 


20 IDAMVSEG moves one segment from the user’s area to a 
buffer. 


21 IDAADSEG builds a sequence-set entry for the segment. 
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Notes for Figure 25 


1 IDAOI19RL removes an unspanned record from a control 
interval (ERASE), updates a previously read unspanned 
record if its length doesn’t change (PUT-update), or, if an 
updated record’s length is different, erases the record’s 
contents in the control interval and calls IDA019RM to 
insert the record into the control interval (PUT-update). 


2 If arecord was erased, IDATJXIT provides the necessary 
journaling information for the user’s journal exit routine. 


If the record is a different size, IDAO19RM inserts it. 


4 If the control interval must be split (the new information 
is greater than the amount of free space in the control 


interval), the control interval’s original records (before the 


split) are journalled. IDATJXIT provides the necessary 
journaling information for the user’s journal exit routine. 
data buffer. 


§ CIFUL processes the control interval when it is full and its 


contents is split (put into two control intervals). 


6 The control-interval-split process requires the exclusive 
use of the DIWA control block. If another request is using 
the DIWA, IDADRQ waits until the DIWA 1s available. 


7 IDAOI19RE splits the control interval. 


See Figure 26 when the control interval is split during data 
set creation or during entry-sequenced data set processing. 


See Figure 27 when the control interval is split during 
key-sequenced data set processing after the data set is 
created. 


8 IDAOI19RS erases or updates a spanned record. 
9 IDAO19RC locates the record’s entry in the sequence set. 


10 CLEARSEG gets a buffer, clears it to free space, and 
writes it to auxiliary storage. 


11 DELSEG removes a segment’s entry from the sequence 
set. 


12 IDAWRBFR writes the updated sequence-set record. 


13 IDAO019RF splits the control area if the updated record 
has additional segments for which free control intervals 
aren't available in the control area. 


14 IDAO19RC locates the record’s entry in the sequence set. 


15 IDAMVSEG moves a segment from the user’s area to a 
buffer. 


16 CLEARSEG clears to free space the control intervals 
occupied by segments removed from an updated record. 


17 DELSEG removes a segment’s entry from the sequence 
set when the updated record has fewer segments than the 
original record. 


18 IDAADSEG builds entries in the sequence set for 
additional segments in the updated record. 


19 IDAWRBFR writes the updated sequence-set record. 
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Notes for Figure 26 


1 IDAO19SA obtains the next (sequential) control interval 
to contain the data records. IDA019SA selects this path 
when the data set (key-sequenced of entry-sequenced) is 
being created, or when an entry-sequenced data set is 
being processed. 


2 IDAO19RG builds an index entry (in the sequence-set 
control interval) for the full data control interval. 


3 VSAM is designed so that the sequence set control interval 
can contain an index entry for each data control interval 
in a control area. Sometimes, when the keys are very long, 
the sequence-set control interval is filled even though 
some of the control intervals haven’t been loaded with 
data records yet. When this occurs, IDA019RG (at 2) 
returns a condition code indicating that the index entry for 
the full data control interval hasn’t been built. EOCA 
writes each unused control interval in the control area 
(associated with the full sequence-set contral interval) as a 
free control interval. EOCA then writes the full data 
control interval into the first control interval of the next 
control area. 


4 IDAWRBER writes the full buffer containing the data 
control interval into the data set (the first control interval 
of the next control area). 


5 If the caller is creating the data set and specified the 
“speed option”, the unused control intervals in the control 
area have not been preformatted. IDA019RK preformats 
them—rewrites them as free-space control intervals. 


6 If the data set (or key range, if this describes step 14’s 
EOCA) is out of space, IDAEOVIF calls End of Volume 
to obtain another secondary space allocation for the data 
set (or key range). 


7 IDAO19RG writes the full sequence set control interval 
into the index. 


8 If the caller specified the “recovery option”, IDA019RK 
preformats the next control area’s control intervals. 


9 IDATSIXIT provides journal information about the data 
that is going into the new control area for the user’s 
journal exit routine. 


10 IDA019RG builds an index entry to describe the first 
control interval in the new control area and puts it into the 
new control area’s sequence set control interval. 


11 IDAFREEB frees the buffer that contains the full data 
control interval. 


12 IDAGNNEL obtains an empty buffer to continue the 
caller’s data set create proccessing. 


13 BUILDFS initializes the buffer as a free-space control 
interval. 


14 When the caller's key-sequenced data set is divided into 
key ranges and the key of the record being added is 
greater than the high key of the key range, EOCA writes 
the buffer containing the control area’s last record into the 
control area. EOCA then writes each unused control 
interval in the control area as a free-space control interval. 
EOCA determines the RBA of the next key-range’s first 
control area and writes the record into the new control 
interval. 


15 When the caller’s new record exceeds the capacity of the 
last control interval in the control area, EOCA determines 
the next control area and performs necessary processing 
to allow the caller to continue data set create processing. 
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Figure 27. Split a Control Interval: Key-Sequenced Data Set, NonCreate-Time Processing 
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Notes for Figure 27 


1 IDAO19RE divides a control interval’s records between the 
control interval and a free-space control interval. 


2 If the sequence set record associated with the control 
interval has been modified by some other request, 
IDAGRB obtains a current copy of the sequence set 
control interval in a buffer. 


3 If the data control interval has been modified by another 
request before it has been written back to the data set, 
IDAWRBER writes the updated control interval into the 
data set. 


4 If the control interval’s control area doesn’t contain a 
free-space control interval, IDAO19RF splits the control 
area. 


5 IDAGNNEL obtains an empty buffer. The buffer is used 
to build the new data control interval, using records from 
the control interval being split. 


IDAO19RE distributes the records between the current 
control interval (being split) and the new control interval 
(in the newly obtained buffer). 


6 IDA0O19RM inserts the data record (the record that 
wouldn't fit and caused the control interval split) into the 
control interval. 


7 IDAO19RH builds an index entry for the new control 
interval. IDA0O19RH also puts the entry in the sequence set 
control interval associated with the control area. 


8 Ifthe entry won't fit in the sequence set control interval, 
IDAO19RE forces a control area split. IDAFREEB frees 
the buffer that was obtained to contain the new data 
control interval. 


9 IDAOI9RF splits the control area. 


10 If the user's exit list contains an active journal exit 
address, IDATJXIT provides journaling information 
about the control area split and the data records that were 
moved from one control interval to another. 


11 If the user's exit list contains an active journal exit 
address, IDATJXIT provides journaling information 
about the data records that were moved within the control 
interval to allow the new data record to be inserted. 


12 IDAWRBEFR writes the new control interval into the data 
set. Of the two control intervals that resulted from the 
control interval split, this control interval contains the 
records with the highest keys. 


13 IDA019RH writes the updated sequence set record (from 
set 17). 


14 IDAWRBEFR writes the updated (old) control interval into 
the data set. 


15 IDAFREEB frees the buffer obtained during 5. 
IDAO19RE repositions the sequence set pointers to point 
to the data control interval into which the insert was made 


16 IDASBF releases all other buffers associated with the 
placeholder (PLH). 
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S 


Notes for Figure 28 


1 IDAOI9RF moves some of a control area’s control 
intervals into a free-space control area. 


2 If afree-space control area is not available, IDAEOVIF 
calls End of Volume to obtain more space for the data set. 


3 IDAGRB obtains a current copy of the control area’s 
sequence set record. 


4 IDAOI19RK preformat’s the free-space control area. 


If the control area can’t be split because it is filled with a 
single spanned record, IDAO019SF builds a new 
sequence-set record and clears a data buffer to free space: 


6 IDAFREED frees the current sequence-set buffer. 
IDANEWRD initializes a new sequence-set record. 
New Key Less Than Old Key 


(The “‘old”’ key is the key of the spanned record that fills 
the control area.) 


8 IDAWRBER writes the new sequence-set record. 


9 IDAO19RV obtains the sequence-set record that 
precedes the sequence-set record of the control area 
filled with the spanned record. IDAO19RV changes the 
sequence-set record’s horizontal pointer to point to the 
new sequence-set record (step 7). 


10 IDAWRBER writes the sequence-set record (step 9). 
New Key Greater Than Old Key 
11 IDAWRBER writes the new sequence-set record. 


12 IDAGRB reads the sequence-set record of the control 
area filled with the spanned record and changes its 
horizontal pointer to point to the new sequence-set 
record. 


13 IDAWRBEFER writes the sequence-set record (step 12). 


14 IDAHLINS changes the second-level index record to point 
to the new sequence-set record. 


15 IDAABF obtains as many buffers as possible to allow the 
Control-Area-Split routine to function as smoothly as 
possible. The maximum number of buffers obtained is 
equal to the number of control intervals to be moved into 
the new control area. The buffers are used to copy control 
intervals from the old control area and rewrite them into 
the new control area. 


16 IDAGRB obtains a copy of the first control interval that is 
to be copied into the new control area. 


17 When this sequence is repeated for subsequent control 
intervals, IDAGNXT obtains the next sequential data 
control interval in the control area until all control 
intervals that are to be moved have been processed. 


IDAO19RF modifies the output RBA value in the control 
interval buffer’s BUFC, so that the control interval is 
written into the new control area. 


18 IDAFREEB frees the buffer. The buffer’s contents will be 
written into the new control area; when it is used agdin to 
contain another control interval. 


17 and 18 are repeated for each control interval in the old 
control area that is moved into the new control area. 


19 IDAWRBFR writes all buffers not yet written into the new 
control control area. 


20 IDAO19RI builds a new sequence set record for the control 
area and adjusts other higher-level index records to point 
to the new sequence set record. 


21 IDAGRB obtains a current copy of the old control area’s 
sequence set record. 


22 If the user’s exit list contains an active journal exit, 
IDATIJXIT provides journaling information about the 
control interval being moved—its old and new RBAs. 


If the sequence set record could not be split at the point 
the data was split, some control intervals in the new 
control area are removed from the new control area so 
that both old and new seqeunce set records are accurate. 
These control interval’s are rewritten as free-space control 
intervals in the new control area; they remain intact in the 
old control area. 23 through 25 process this exceptional 
condition. 


23 IDAGNNEL obtains an empty buffer. IDAOI9RF builds a 
free-space control interval in it. 


24 IDAFREEB frees the buffer, so that it will update the 
control area with a free-space control interval when the 
buffer is used next. 


25 IDAWRBEFR writes all buffers not yet written into the new 
control area. 


26 IDAGNNEL obtains an empty buffer. IDAOI9RF builds a 
free-space control interval in it. The free-space control 
interval replaces each control interval in the old control 
area that has been copied into the new control area. 


27 IDAFREEB frees the buffer, so that it will update the old 
control area with a free-space control interval when the 
buffer is used next. 26 and 27 are repeated until all control 


intervals in the old control area that have been copied are 
deleted. 


28 IDAWRBEFER writes all buffers not yet written into the old 
control area. 


29 If the insert point for the record to be added to the data 
set is in the new control interval, IDAFREEB frees the 
buffer that contains the old sequence set control interval. 


30 IDAGRB obtains a copy of the sequence set control 
interval associated with the new control area. 


31 If the record is to be inserted at the end of the data set, 
IDA019RM inserts the record. No further control area 
split processing is performed. 


32 If the record is not to be added to the end of the data set, 
IDASBF releases all buffers associated with the 
placeholder, except the buffers contained the data record's 
insert point and the sequence set control interval. 


33 Same as 32. 


34 IDAGRB obtains a current copy of the data control 
interval that contains the data record’s insert point. 


IDAO19RF returns to the control interval split routine to 
split the control interval and insert the data record. 
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Figure 29. Create-Time Sequence-Set Record Processing: Build an Entry 
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Notes for Figure 29 


IDAO19RG is called by IDA019SA when a key-sequenced 
data set is being created. 


1 This figure describes the addition of an index entry to the 
sequence-set control interval when a data control interval 
is full. 


2 If IDAO19RG is being called for the first time, IDAAQR 
obtains a control interval for a sequence-set record. 


3 If all allocated space in the data set has been used, 
IDAEOVIF obtains another extent for the data set. 


4 If the newly obtained extent must be preformatted before 
it can be used, IDA019RK preformats it. 


5§ INTNEWRC initializes the control interval as a 
sequence-set control interval. 


6 IDAGNEFL obtains a buffer for the sequence-set control 
interval. 


7 IDAIST uses the high key value of the data control 
interval to build an index entry in the sequence-set control 
interval. The key is front and rear compressed before the 
entry is built. 


If there is not enough room to insert the.index entry in the 
sequence-set control interval, IDA019RG indicates this 
and returns to IDAO19SA. The entry is not put in the 
sequence-set record. 
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Figure 30. Create-Time Sequence-Set Record Processing: Write the Record (End of Control Area) 
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Notes for Figure 30 


1 When the control area is full, IDA019RG writes its 
sequence-set record into the index and initializes a new 
sequence-set record for the new control area. 


2 IDAWR writes the updated sequence-set record into the 
index. This is the sequence-set record associated with the 
old control area. 


3 IDAAQR obtains the next control interval for a 
sequence-set record. 


If all allocated space in the data set has been used, 
IDAAQR calls IDAEOVIF to obtain another extent for 
the data set. 


If the newly obtained extent must be preformatted before 
it can be used, IDAAQR calls IDA019RK to preformat it. 


4 INTNEWRC initializes the control interval as a 
sequence-set record. 


5 IDAGNEL obtains a buffer for the sequence-set record. 


IDAWR writes the new sequence-set record with a dummy 
index entry—an entry with length=0 and front-key 
compression=0. 


7 Read obtains a copy of the previously written (from 2) 
sequence-set record. 


IDA019RG builds a horizontal pointer entry to allow the 
record to point to the newly created sequence-set record. 


8 IDAER removes the dummy entry from the sequence-set 
record. 


9 IDAWR writes the updated (previous, from step 7) 
sequence-set record into the index. The sequence-set 
record now has the “‘proper” ending entry. 


IDA019RG adjusts the higher-level index records to 
reflect the addition of a new sequence-set record. 


10 When a higher-level index record is required, IDAAQR 
locates the control interval containing it. 


If all allocated space in the data set has been used, 
IDAAQR calls IDAEOVIF to obtain another extent for 
the data set. 


If the newly obtained extent must be preformatted before 
it can be used, IDAAQR calls IDA019RK to preformat it. 


IDA019RG obtains more virtual storage (using 
GETMAIN) for another ICWA, if all other ICWAs are 
being used, and initializes it. 


11 IDAR reads in the higher level index record. 


12 IDAIST builds an index entry to describe the sequence-set 
index record and puts it into the higher level index record. 


13 If the entry won't fit in the higher level record, 
IDAFREEB frees the buffer containing the higher level 
index record (from 11). 


14 IDAWR writes out the updated higher level index record, 
so that the index is always as current as possible. Steps 10 
through 14 are repeated to update as many levels of the 
index as are required. 


15 INTNEWRC initializes a buffer for the new sequence-set 
index record. index record. 


16 IDAGNFL obtains an empty buffer for the new 
sequence-set index record. 
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Figure 31. Create-Time Sequence-Set Record Processing: Write the Record (Closing the Data Set) 
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C 


Notes for Figure 31 


1 


When the user closes the data set after he creates it, 


IDA019RG writes the last sequence-set record into the 
index. 


IDAWR writes the sequence-set record into the index. 
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Figure 32. NonCreate-Time Sequence-Set Processing 
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Notes for Figure 32 


1 


IDA019RH builds an index entry and inserts it in the 
proper position in the sequence-set record when a control 
interval is split. 


IDAO19RC searches the compressed index entries in the 
sequence-set record to locate the insert point for the new 
index entry. 


COMPRS performs rear key compression for the newly 
built index entry. 


COMPRS modifies the front and rear key compression of 

index entries in the sequence-set record that might require 
modification as a result of inserting a new compressed key 
entry. 


IDAWRBER writes the updated sequence-set record into 
the sequence set. 
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Figure 33. Update the Index: Adding to the End of a Key Range or Data Set 
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Notes for Figure 33 


1 


8 
9 


IDAO19RI updates higher level index records when a 
control area is split. If the control area being split is at the 
end of a key range or data set, this figure describes the 
updating sequence. 


ENTKEY locates and extracts the next to last section 
entry from the index record. 


ENTKEY extracts the last section entry from the index 
record. 


IDAFREEB frees the current index record. 
NEWRCRD builds and initializes a new index record. 
IDAAQR obtains a RBA value for the new index record. 


If all allocated space in the data set has been used, 
IDAAQR calls IDAEOVIF to obtain another extent for 
the data set. 


If the newly obtained extent must be preformatted before 
it can be used, IDAAQR calls IDA019RK to preformat it. 


IDAGNEL obtains an empty index buffer for the new 
index record. When the record is built, it will be written 
into the index at the RBA obtained by IDAAQR. 


NEWRCRD builds the new index record. 
IWRITE writes the new index record into. the index. 


IDAO19RH writes the index record. 


10 IDAFREEB frees the index record’s buffer. 
11 GETSREC obtains the previous sequence-set record. 


12 IDAGRB retrieves the newly written index record. 


GETSREC adjusts the index record, removing the last key 
entry from the record. 


13 IWRITE rewrites the updated index record into the index. 
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Figure 34. Update the Index: Splitting a Control Area (Not at the End of a Key Range or Data Set) 
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.. 


Notes for Figure 34 


1 IDAOI19RI updates the higher level index records when a 
control area is split. If the control area being split is not at 
the end of a key range or data set, this figure describes the 
updating sequence. 


2 IDAO19RJ splits the current sequence-set record. 


If the sequence-set record could not be split at the 
specified point, 3 through 7 adjust the split point so that it 
can be split. 


IDAFREEB frees the index buffer. 


4 GETSREC obtains the sequence-set record from the index 
(IDA019RJ destroyed the old copy during its processing.) 


IDAGRB retrieves the sequence-set record. 


6 FINDSP scans the sequence-set record to locate the split 
point. 


7 LNEXTE adjusts the split point by one entry. 2 is retried, 
and 3 through 7 repeat, until the seqeunce-set record is 
split. 


8 IDAO19RB searches the index to locate the insert point in 
the next higher level of the index. 


9 IDAO19RH inserts the new entry in the higher level index 
record. 


If the entry doesn’t fit in the higher level index record, 
steps 10 and 11 attempt to split it. 


10 FINDSP locates the midpoint of the index record entries 
in the higher level index record. 


11 IDAO19RJ splits the index record. If the split could not be 
made at the specified point, 12 through 15 adjust the split 
point so that the record can be split. 


12 IDAFREEB frees the index record’s buffer. 


13 GETSREC obtains the higher level index record from the 
index (IDA019RJ destroyed the copy in the buffer during 
its processing). 


14 IDAGRB retrieves the index record. 


15 LNEXTE adjusts the split point by one entry. 11 is retried, 
and 12 through 15 repeat, until the index record is split. 
When the split is correct, 8 and 9 insert the entry that 
would not fit before. 


16 IWRITE writes the index record containing the new entry 
into the index. 


17 IDA019RH writes the index record. 
18 IDAFREEB frees the index record’s buffer. 


19 If a new high-level index record was built by this index 
upgrading processing, IDAEOVIF updates the catalog 
information for the index. 


20 If a new high-level index record is needed, NEWRCRD 
obtains a RBA and buffer for the record. NEWRCRD 
builds the new record and does 16 through 19 to write the 
record and adjust the index’s catalog information. 


21 IDAAQR obtains a RBA value for the new high-level 
index record. 


If all allocated space in the data set has been used, 
IDAAQR calls IDAEOVIF to obtain another extent for 
the data set. 


If the newly obtained extent must be preformatted before 
it can be used, IDAAQR calls IDA019RK to preformat it. 


22 IDAGNEFL obtains an empty index buffer for the new 
index record. When the record is built, it will be written 
into the index at the RBA obtained by IDAAQR. 
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Figure 35. PUT/ERASE Processing (RRDS) 
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Notes for Figure 35 


1 IDAO19R1 is the common Record Management request 
module. It verifies that the request is valid and checks for 
keyed processing of a relative record data set. 


2 IDAO19RR selects the processing path for GET, PUT, 
POINT, or ERASE and for direct, sequential, or skip 
sequential access. 


Update or Erase 


PUT-update or ERASE requires that a GET-update was 
previously issued. Therefore, the control interval that 
contains the record to be updated or deleted is in the data 
buffer, and the PLH points to the record. 


3 For PUT-update, IDA019RQ lays the updated record over 
the old record. For ERASE, IDA019RQ fills the slot with 
binary zeros and changes the RDF to indicate an empty 
slot. 


4 For a direct request that is not to have string position 
noted, IDAWRBEFR writes the data buffer to the control 
interval. 


IDAFREEB frees the data buffer. 


6 If the user’s EXLST contains an active journal exit 
address, IDATJXIT provides the necessary journaling 
information for the user’s journal exit routine. 


Insert 


The slot indicated by the search argument or by current 
positioning must be empty. If it isn’t, the record to be inserted 
isn’t inserted, because of duplicate record. 


7 PUTNONSQ locates the control interval for a direct or 
skip sequential request. The search argument (relative 
record number) is converted to the RBA of the control 
interval that contains it and the offset of the record in the 
control interval. 


8 For skip sequential access, IDARRDRL verifies that the 
search argument is greater than the previous one, 
indicated by positioning. It retrieves the control interval 
by RBA and sets the PLH pointer to the indicated slot. 


9 If the indicated relative record number is in a control 
interval beyond the last control interval currently in the 
data set, GETSPACE calls IDA019RK to preformat the 
next control area. If processing is for creation (the data set 
was empty when opened) with the SPEED option, the rest 
of the control intervals in the current control area are 
preformatted before a new control area is preformatted. 
Control intervals are preformatted until the one that 
contains the indicated relative record number has been 
preformatted. GETSPACE calls IDAEOVIF when 
additonal space is needed for control areas. 


10 To insert the record into a slot in a control interval not 
currently in the data set, no control interval is read. 
IDAGNNEL gets an empty data buffer and formats it 
with empty slots. 


PUTSQIST locates the first control interval of the data set 
when the first request after OPEN is sequential. 


12 IDAABF adds additional buffers to the buffer chain for 
read-ahead buffering. 


13 If processing is not for creation (that is the data set 
contained formatted control areas when opened), 


IDARRDRL retrieves the first control interval and sets 
the PLH pointer to the first slot in the control interval. 


14 If processing is for creation, IDAGNNFL gets an empty 
data buffer and formats it with empty slots. 


NonCreate 


15 PUTSQNCR processes sequential requests when 
processing is not for creation. If the previous request was 
POINT with KGE (key greater than or equal), the control 
interval identified by the search argument of the POINT is 
retrieved. Otherwise PUTSQNCR advances the PLH 
pointer to the next slot. If there are no more slots in the 
control interval, the next control interval is retrieved. 


16 When additional space is allocated, IDADRQ gets 
exclusive use of the data set for extension. 


17 When the next control interval is in the next control area, 
GETSPACE calls IDA019RK to preformat the next 
control area. If additional space is needed for the next 
control area, GETSPACE calls IDAEOVIF to allocate the 
space and preformat the first control area in it. 


18 When there are no more slots in the current control 
interval, IDAFREEB frees the current data buffer. 


19 IDAGNXT retrieves the next sequential control interval. 


20 If the previous request was POINT with KGE, 
PUTNONSQ retrieves the control interval identified by 
the search argument of the POINT. 


Create 


21 PUTSQCRE processes sequential requests when 
processing is for creation. PUTSQCRE advances the PLH 
pointer to the next slot in the current data buffer. 


22 When the next control interval is in the next control area, 
GETSPACE calls IDA019RK to preformat the next 
control area. If additional space is needed for the next 
control area, GETSPACE calls IDAEOVIF to allocate the 
space. Unless the SPEED option is indicated, IDAEOVIF 
preformats the first control area in the newly allocated 
space. 


23 When there are no more slots in the current control 
interval, IDAFREEB frees the current data buffer. 


24 When the next control interval hasn’t been preformatted, 
IDAGNNEL gets an empty data buffer and formats it 
with empty slots. 


25 When the next control interval has been preformatted and 
the RECOVERY option is indicated, IDAGNXT retrieves 
the next control interval and puts it in the data buffer. 


26 When the next control interval has been preformatted and 
the SPEED option is indicated, IDAGRB retrieves the 
next control interval by RBA and puts it in the insert 
buffer. Using the insert buffer causes an update-write 
channel program to be used when the control interval is 
written. 


IDA019RQ moves the record to be inserted into its slot, 
unless the slot already contains a record. The record to be 
inserted is considered a duplicate. 


27 For a direct request that is not to have string position 
noted, IDAWRBER writes the data buffer to the control 
interval. 


28 IDAFREEB frees the data buffer. 
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29 For a direct request that is not to have string position 
noted, where the current data buffer is the insert buffer, 
IDASBF writes the insert buffer and removes it from the 
normal buffer chain. 


30 If the user’s EXLST contains an active journal exit 
address, IDATJXIT provides the necessary journaling 
information for the user's journal exit routine. 
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Figure 36. Path Processing 
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Notes for Figure 36 


IDAO19R1 checks the user’s RPL for validity and assigns a 
PLH to it. It detects a request for access to a base cluster 
by way of an alternate index. 


IDA019RX builds an inner RPL to be used in retrieving 
the alternate-index record needed for the request. 


IDAO19R4 retrieves the alternate-index record needed for 
the request. 


If IDA019R4 detected that the user’s data area was too 
small for the alternate-index record, IDA019RX increases 
the size of the area. 


IDA019RX builds an inner RPL to be used for the request 
for access to the base cluster. 


IDA019R4 issues the request for access to the base cluster. 


IDAO19RX transfers any return code from the inner RPL 
to the user’s RPL. 
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Figure 37. Upgrade Processing 
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Notes for Figure 37 


1 


For a PUT or ERASE, when there is an upgrade table 
(UPT)—which indicates that the base cluster has an 
upgrade set, IDA019R4 calls IDAOI9RU for upgrade 
processing. 


For each alternate index in the upgrade set, IDA019RU 
determines whether the PUT or ERASE requires an 
alternate-index record or a pointer in an alternate-index 
record to be added or removed. 


For each alternate index that requires upgrading, 
IDAO019R4 does the I/O to accomplish upgrading. 


If each alternate index was upgraded successfully, 
IDAO019R4 does the I/O for the PUT or ERASE. 


If the I/O for the PUT or ERASE failed, IDA019RU 
backs out (undoes) the upgrading for each alternate index. 


For each alternate index whose upgrading was backed out, 
IDAO019R4 does the I/O to accomplish backing out. 
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Figure 38. (Part 1 of 3) Buffer Management 
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Notes for Figure 38 (Part 1 of 3) 


1 IDA0O19RZ is entered for all frequently used Buffer 
Management functions. It sets a code in a register that 
indicates the requested function. For requests without 
shared resources specified, it calls IDA019R2; for requests 
with shared resources specified, it calls IDAOI9RY. Some 
procedures (such as IDAFREEB) are literally part of 
IDA019RZ, but their processing actually takes place in 
IDA019R2 or IDAO19RY. (For example, in this figure 
IDAFREEB is shown as a procedure of both IDA019R2 
and IDAOI9RY.) 


Without Shared Resources 


2 IDAFREEB makes an index or insert buffer available for 
reassignment. For sequential retrieval, when IDAFREEB 
frees a data buffer, it initiates read-ahead buffering if 
enough free buffers are available for it. 


3 For read-ahead buffering, IDAWAIT lets any previously 
started I/O finish. 


4 IDAFRBA determines the RBA of the next control 
interval. 


5 When one or more of the RBAs in the I/O chain are not 
in ascending sequence, IDARVRSI puts them in 
ascending sequence. 


6 IDA019R3 (I/O Management) issues I/O for read-ahead 
buffering. 


7 IDAWRBER writes the buffer (s) in the current I/O chain. 


IDAWAIT lets any previously started I/O finish. 


IDA019R3 (I/O Management) issues I/O for the current 
chain. 


10 IDAWAIT lets the I/O started in step 9 finish. 


11 IDASBF moves buffer (s) from the I/O chain back to the 
buffer pool. 


12 Before IDASBF moves a buffer back to the buffer pool, 
IDAWRBER ensures that no writes are pending against 
the buffer. 


13 IDAWAIT lets any I/O pending against the buffer finish. 
14 IDAGRB reads an index or a data control interval. 
15 IDAWAIT lets any previously started I/O finish. 


16 IDARVRS1 puts in ascending sequence any RBAs in the 
I/O chain that are out of order. 


17 Unless the index or data control interval is already in the 
buffer pool, IDA019R3 (I/O Management) issues I/O to 
read it. 


18 IDAGNEFL supplies a work buffer for index processing or 
for a control-interval split. 


19 IDAGNNEL supplies an empty data buffer for sequential 
output processing. 


20 IDAWAIT lets any previously started I/O finish. 


21 When enough buffers are already flagged for output, 
IDA019R3 (I/O Management) issues I/O to write them. 


22 If the current buffer’s contents have been modified, 
IDAWRBER write it. 


23 IDAWAIT lets any I/O pending against the buffer finish. 





74 IDAGNXT ensures that the next data control interval has 
been read and provides a pointer to the buffer that 
contains it. 


25 IDAWAIT lets any pending I/O finish. 


26 IDA019R3 (I/O Management) issues I/O to read a buffer 
that was not read previously because another request had 
exclusive control of it. 


27 IDAEXCL obtains exclusive control of a control interval 
identified by RBA. 


28 IDAGWSGW obtains an empty data buffer from the 
current I/O chain. 


With Shared Resources 
29 IDAFREEB makes a buffer available for reassignment. 
30 IDAWRBER writes a buffer. 


31 If the user’s EXLST contains an active journal exit 
address, IDATJXIT notifies the journal exit routine of an 
impending write. 

32 IDA019R3 (I/O Management) issues I/O for the write. 

33 IDAWAIT lets I/O for the write finish. 


34 If an I/O error occurred, IDA019R5 builds an error 
message. 


35 If an I/O error occurred and the AMB contains an 
exception exit address, IDAEXEX passes control to the 
exception exit routine. 


36 If an I/O error occurred and the user’s EXLST contains 
an active journal exit address, IDATJXIT passes control 
to the journal exit routine. 


37 IDASBF frees the current buffer. 


38 If the buffer’s contents have been modified, IDAWRBFR 
writes it. 
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Figure 38. (Part 2 of 3) Buffer Management 
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Notes for Figure 38 (Part 2 of 3) 
39 IDAGRB reads an index or a data control interval. 


40 If the buffer is already being read, IDADRQ suspends 
processing for the current request. 


41 Unless the index or data control interval is already in the 
buffer pool, READBFR reads it. 


42 IDA019R3 (I/O Management) issues I/O for the read. 
43 IDAWAIT lets the I/O started in step 42 finish. 


44 If an I/O error occurred, IDA019R5 builds an error 
message. 


45 If an I/O error occurred and the user’s EXLST contains 
an active journal exit address, IDATJXIT passes control 
to the journal exit routine. 


46 If an I/O error occurred and the AMB contains an 
exception exit address, IDAEXEX passes control to the 
exception exit routine. 


47 IDAGNEFL supplies a work buffer for index processing or 
for a control-interval split. 


48 IDAGNNEL supplies an empty data buffer for sequential 
output processing. 


49 IDAGNXT ensures that the next data control interval has 
been read and provides a pointer to the buffer that 
contains it. 


50 IDAFRBA determines the RBA of the next control 
interval. 


51 IDAGRB obtains the control interval. 


52 IDAWRTBF processes a WRTBFR macro to write the 
buffer(s) indicated by the caller. 


53 If any of the buffers to be written are being used by 
another request, IDADRQ suspends processing for the 
current request until the other request makes the buffers 
available. 


54 IDAWRBER writes the buffers. 


55 IDASCHBF processes a SCHBFR macro to search the 
buffer pool for the RBA indicated by the user. 


56 If a buffer contains the indicated RBA but is in the process 
of having the control interval read into it, IDADRQ 
suspends processing for the current request until reading is 
finished. 


57 IDAMRKBF processes a MRKBFR macro to mark a 
buffer to be released or for output. 


58 IDAGWSGW obtains an empty data buffer from the 
current I/O chain. 


59 If the buffer’s contents have been modified, IDAWRBFR 
writes it. 


60 For a synchronous request, IDAWAIT issues a WAIT 
macro for the I/O to finish. For an asynchronous request, 
IDAWAIT sets a flag for the I/O Manager’s 
Asynchronous Routine to pass control to IDAWAIT after 
the I/O is finished. 
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Figure 38. (Part 3 of 3) Buffer Mannagement 
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Notes for Figure 38 (Part 3 of 3) 


61 IDAO19RW receives requests for Buffer Management 
functions that are used only infrequently. 


62 For processing without shared resources, IDAABF adds 
buffers to a string’s I/O chain to shorten processing time. 


63 For processing without shared resources, IDAAIBF adds 
the insert buffer to a string’s I/O chain for a control-area 
split or for updating or inserting a spanned record. 


64 For processing without shared resources, IDAGWSGW 
locates empty buffer(s) in the string’s I/O chain so that a 
spanned record can be inserted or lengthened (with 
additional segments) without using buffers that are being 
used for read-ahead buffering. 


65 IDAWRBEFER writes empty buffers whose contents have 
been modified. 


66 IDAFRBA determines the RBA of the next control 
interval. 


67 When the next RBA in sequence is in the next control 
area, IDAWRBFR prevents subsequent repositioning to a 
preceding control area for writing. 


68 For processing with shared resources, IDAGRB reads the 
index control interval that contains the current 
sequence-set record. 


69 When sequence-set pointers become invalid (because of a 
control-interval split or processing with shared resources), 
IDAO19RC searches the sequence set for the current key. 


70 For processing without shared resources, IDA019R3 (I/O 
Management) issues I/O to read a sequence-set record. 


71 For processing without shared resources, IDAWAIT lets 
the I/O started in step 70 finish. 


72, When the next RBA in sequence is in the next control 
area, IDAWRBEFER prevents subsequent repositioning to a 
preceding control area for writing. 


73 For backward processing, IDAO19RV obtains the 
sequence-set record preceding the current sequenct-set 
record. 


74 For processing with shared resources, IDAGRB obtains 
the next sequence-set record. 


75 For processing without shared resources, IDA019R3 (I/O 
Management) issues I/O to read the next sequence-set 
record. 


76 IDAWAIT lets the I/O started in step 75 finish. 
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Figure 39. VSAM End of Volume (from VSAM Record Management: IDAEOVIF Procedure (in Module IDA019RS5)) 
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Notes for Figure 39 


1 IGCOOOSE and IFG0551F are VS2 End-of-Volume 
modules (see OS/VS2 Open/Close/EOV Logic for 
details). 


2 IFGOS5SOY is an alias-name for IFGO200N. It performs 
special processing for the VS2 catalog’s ACB and is called 
when End of Volume is called for a catalog. 


IFG0557A is an alias-name for IFG0192A. 
4 IDA0557A is the VSAM End-of-Volume module. 


IDA0192C calls VS2 Catalog Management (LOCATE) to 
retrieve the volume time stamp from the volume entry. 


6 IDA0192V ensures that the required volumes are mounted 
for the VSAM object. 


7 If the data set is stored on a mass storage volume, 
IDA0192D stages (via a Mass Storage System ACQUIRE) 
the new volume to a direct-access storage device. 


8 If the data set is stored on a mass storage volume, 
IDA0192D stages any new extents to a direct-access 
storage device. 


9 IDA0192S writes SMF record(s) type 64. 


10 IDA0192C calls VS2 Catalog Management (LOCATE and 
UPDATE) to locate and update information in the 
object’s catalog record. 


11 Whenever End of Volume detects an error, IDA0192P 
issues a diagnostic message and traces VSAM control 
blocks if the Generalized Trace Facility (GTF) is active. 


12-13 
IDAOCEAI runs as an ESTAE exit when an error occurs 
in Open. It logs system information and returns to the VS2 
I/O Support Recovery Routine to continue with 
termination. 


14-15 
IDAOCEA2 locates and frees storage used for VSAM 
data sets in the system queue area and the common 
service area. 
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Figure 40. I/O Management: Translating Virtual Addresses to Real Addresses and Completing a Channel Program for I/O 





266 OS/VS2 Virtual Storage Access Method (VSAM) Logic 


Notes to Figure 40 


1 Buffer Management requests I/O Management to read or 
write data. IDAM19R3 prepares for supervisor-state 
processing and passes a request on to IGC121. 


2 IGC121 chains together the CPAs required for the request 
and determines whether the RBAs of records or control 
intervals in the request are covered by the extent 
definition blocks (EDBs) that exist for the data set. 
IGC121 builds lists of virtual and real addresses for use by 
the channel program that the VS2 I/O Supervisor will 
execute to do I/O. 


3 The VS2 PGFIX Routine fixes in real storage the virtual 
pages that contain the buffers required to do the I/O. 


4 The VS2 PGFREE Routine releases pages that have been 
fixed in real storage in the case where an error occurs in 
virtual-to-real address translation and IGC121 cannot 
continue with the request. 


5 VS2 IEASMFEX sets up for counting EXCPs used by the 
VS2 I/O Supervisor in doing I/O. 


6 IDA121A2 completes the segments of channel programs 
passed to it by IGC121 (or by the OS/VS Auxiliary 
Storage Manager, which enters I/O Management at 
IDA121A2) and chains them together to form a single 
channel program for use by the VS2 I/O Supervisor. 


7 VS2 IECSCR1 converts the physical-record number in the 
first channel program segment into a sector value for use 
with devices having rotational position sensing. 


8 The VS2 Basic I/O Supervisor receives a STARTIO 
request from IDA121A2. It schedules the I/O and returns 
to IDA121A2. 


9 After I/O completion, the VS2 I/O Supervisor Post Status 
Routine determines whether the I/O was successful and 
decides which VSAM end appendage should get control. 


10 The VS2 Recovery Termination Manager gets control 
when an error occurs in VS2. If a functional recovery 
routine has been set up to get control in case of an error, 
the Recovery Termination Manager gives control to it. 


11 IDA121F2 is the functional recovery routine for 
IDA121A2. It frees pages fixed in real storage by IGC121, 
releases the local lock that IDA121A2 obtains for storage 
protection, and issues an SDUMP macro to record 
information in SYS1.DUMP. 


12 See step-10 note. 


13 IDA121F1 is the functional recovery routine for IGC121. 
Its processing is similar to that described in step-11 note. 


14 When IDAM19R3 defers a request because End of 
Volume is processing and the request requires that the 
processing be completed or that End of Volume do other 
processing for the request, IDADRQ awaits an indication 
that End of Volume is finished. 


15 IDAEOVIF handles a request from IDAM19R3 for 
End-of-Volume processing. IDAM19R3 expects End of 
Volume to create an EDB to cover some RBA in the 
request from Buffer Management. 


16 See step-10 note. 


17 PIODFRR is the functional recovery routine for 
IDAM19R3. It releases the local lock that IDAM19R3 
may have obtained for storage protection and issues an 
SDUMP macro to record information in SYS1.DUMP. 
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Figure 41. I/O Management: Processing after VS2 I/O Supervisor Completes I/O 
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Notes for Figure 41 


1 After I/O completion, the VS2 I/O Supervisor Post Status 
Routine determines whether the I/O was successful and 
decides which VSAM end appendage should get control. 


2 IDA121A3 indicates I/O completion in the BUFCs and 
does housekeeping following successful I/O and provides 
for the caller of I/O Management to get control back. 


3 Inthe case where I/O activity is being allowed to continue 
to completion, but no new I/O is being started (for 
quiescing the task), IECVQCNT decrements the count of 
outstanding I/O. (When the count is reduced to 0, the task 
can be closed down.) 


4 For asynchronous request, the VS2 POST Routine 
indicates in an ECB that I/O has completed. 


§ For an asynchronous request or for a synchronous request 
when End of Volume is waiting to process, the VS2 Stage 
II Exit Effector schedules IDA121AS5. 


6 IDAI1214AS itself gets control asynchronously in relation to 
the end appendage to give control back to the requester of 
I/O or to End of Volume. 


See step-3 note. 


8 The VS2 PGFREE Routine releases pages fixed in real 
storage by IGC121. 


9 The VS2 Recovery Termination Manager gets control 
when an error occurs in OS. If a functional recovery 
routine has been set up to get control in case of an error, 
the Recovery Termination Manager gives control to it. 


10 IDA121F3 is the functional recovery routine for 
IDA121A3. It duplicates the processing of IDA121A3, in 
order to continue processing if possible. 


11 F3FRR is a functional recovery routine within IDA121F3. 
It frees pages fixed in real storage by IGC121 and issues 
an SDUMP macro to record information in SYS1.DUMP. 


12 IDA121A4 indicates completion in BUFCs whose I/O 
completed and error in the BUFC whose I/O failed. It 
retries I/O that yet has a chance to complete successfully. 
It does housekeeping and provides for the caller of I/O 
Management to get control back. 


13-19 
See notes for steps 3-9. 


20 IDA121F4 is the functional recovery routine for 
IDA121A4. It frees pages that were fixed in real storage 
by IGC121 and issues an SDUMP to record information in 
SYS1.DUMP. 
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DIRECTORY 


This directory identifies the method of operation diagrams and program 
organization compendiums for the modules and external procedures of 
VSAM. The module directory and the external procedure directory contain 
the same information, ordered differently. 


The microfiche for VSAM contains a “Control Flow Report”’ that lists each 
module and procedure of VSAM, along with the modules and procedures that 


call it or that it calls. 


Module Directory 
The module directory is organized alphabetically by symbolic module name. It 
lists the module’s descriptive name, its external procedure names (external 
entry points), the component to which it belongs, and the method of 
operation diagrams and program organization figures that refer to it. 
The components are identified by: 
C Close 
C/R Checkpoint /Restart 
CBM Control Block Manipulation 
EOV End of Volume 
I ISAM Interface 
IOM I/O Management 
O Open 
RM Record Management 
External Method of Program 
Module Descriptive Procedure Operation Organization 
Name Name Names Component Diagrams Figures 
AMDUSRF9 IMDPRDMP Format Appendage IMDUSRFI — — — 
IDACKRAI1 ESTAE IDACKRAI C/R AJ, AK, AL1, 17, 18 
AM 
IDAICIA1 ISAM-Interface: Data-Set Management IDAICIA1 I AG 11 
Recovery Routine 
IDAIIFBF ISAM Interface: FREEDBUF Processing IDAITFBF Il BU2 — 
IDAIIPM1 ISAM Interface: QISAM Load-Mode Processing IDAIIPM1 II BUI — 
IDAIIPM2 ISAM Interface: QISAM Scan-Mode Processing IDAIIPM2 II BU1 — 
IDAIIPM3 ISAM Interface: BISAM Processing IDAIIPM3 II BU2 — 
IDAIISM1 ISAM Interface: SYNAD Processing IDAITSM1 II BU2 — 
IDAMI19R3_ Problem-State I/O Driver IDAO019R3 IOM BG1, BS1, BS2, 20, 22, 38, 
BS3, BS4, DAI, 40 
DA2, DA3 
PIODFRR IOM DAI 40 
IDAOCEAI1 Data-Set Management Recovery Routine IDAOCEAI1 O/C/EOV AF, AG 8, 10, 11, 
(Force Close Executor) 12, 16, 39 
IDAOCEA2 Task Close Executor IDAOCEA2 O/C/EOV AH1, AH2, AH3 8, 39 
IDAOCEA4 BLDVRP/DLVRP ESTAE Routine IDAOCEA4 O/C/EOV AF, AG 10, 16 
IDAOAOSB _ Restart IDAOAO05B C/R AJ, AL1, AL2 18 
IDAOCOSB  SSCR and Initial DEB IDAOCOSB C/R AK 18 
Processing 


Directory 271 


Module Directory 


Module 
Name 


IDA0C06C 
IDAOI96C 
IDA019C1 
IDA019RA 


IDA019RB 


IDA019RC 


IDA019RD 
IDA019RE 


IDA019RF 


IDA019RG 


IDA019RH 


IDAO19RI 


IDA019RJ 


IDAO19RK 


IDA019RL 
IDA019RM 


IDA019RN 


IDA019RO 


272 OS/VS2 Virtual Storage Access Method (VSAM) Logic 


Descriptive 
Name 


Checkpoint 
SSCR Build and Cleanup 
Control Block Manipulation 


Direct Record Locate 


Index Search 


Search Compressed Index Block 


DD DUMMY Processing 
Control-Interval Split 


Control-Area Split 


Index Create 


Index Insert 


Index Upgrade 


Split Index Record 


Preformat 


Data Modify 
Data Insert 


Indexing Subroutines 


Verify 


External 
Procedure 
Names 


IDA0C06C 
IDA0196C 
IDA019C1 
IDA019RA 


IDA019RB 


IDA019RC 


IDA019RD 


IDA019RE 


IDAREPOS 
IDA019RF 


IDA019RG 


IDAIST 


IDA019RH 


IDAIVIXB 
IDASPACE 
IDA019RI 


IDAHLINS 
IDANEWRD 
IDAOI19RJ 


IDAR 
IDAWR 
IDA019RK 


IDA019RL 
IDA019RM 


IDACHKKR 
IDAO19RN 
IDAAQR 


IDAER 
IDA019RO 


Component 
C/R 

C/R 

CBM 

RM 


RM 


RM 


RM 


RM 


RM 
RM 


RM 


RM 


RM 


RM 
RM 
RM 


RM 
RM 
RM 


RM 
RM 
RM 


RM 
RM 


RM 
RM 
RM 


RM 
RM 


Method of 
Operation 


Diagrams 

Al, AJ 

AJ 

CA, CB1, CB2 


BC, BE, BH1, 
BJ 


BC, BH1, BH8, 
BJ, BM 


BC, BH1, BH2, 
BH6, BI, BJ, 
BM, BS4 


BH1, BH3, BH7 


BH1, BH2, BH3, 
BH4, BH5 


BG1, BG2, BG3, 
BG4, BGS, BK2 


BG3, BG4, BGS, 
BH9 


BH3, BH6, BH7, 
BH8 


BH4, BH5, BH7, 
BH8, BH9 


BH4 
BH4 


BH4, BH7, BH8, 
BH9, BH10 


BG5, BH9, BH10 
BG4, BGS, BH10 


BG?2, BH4, BH8, 
BH9, BK2, BN2, 
BOI 


BH2, BI 


BE, BF, BH 1, 
BH2, BH3 


BG3, BG4, BGS, 
BH8, BH9 


BG5 
BM 


Program 
Organization 
Figures 

17 

17 


20, 21, 22, 
24 


22, 34 


22, 24, 25, 
32 


24, 25, 27, 
28, 32 


24, 25, 26, 
27, 33, 34 


26, 29, 30, 
31 


29, 30 


21; 32, 33, 
34 


28, 33, 34 


28 
28 
34 


30 
30, 31 


24, 26, 28, 
29 


24, 25 


24, 25, 26, 
27, 28, 40 


29, 20, 33, 
34 


30 


J 





Module Directory 


Module Descriptive 

Name Name 

IDAOI9RP ENDREQ and JRNAD 

IDA019RQ Relative Record Subroutines 
IDAO19RR Relative Record Driver 

IDAO19RS  Spanned Record Data Modify 
IDAO19RT Spanned Record Data Insert 
IDAO19RU = Alternate-Index Upgrade Driver 
IDAO19RV Locate Previous Sequence-Set Record 


IDAOI9RW_ Buffer Management, Part 2 


IDA019RX Path Processing Driver 


IDAOI9RY Shared Resources Buffer Management 


IDA019RZ Buffer Management Interface 


External 
Procedure 
Names 


IDAO19RP 
IDAENDRQ 
IDATJXIT 


IDA019RQ 
IDA019RR 


IDARRDRL 
IDAO019RS 
IDAADSEG 
IDAMVSEG 
IDA019RT 
IDADARTV 
IDAJRNSR 
IDASPNPT 
IDA019RU 


IDAXGPLH 
IDAO019RV 
IDAADVPH 
IDARVRS1 
IDA019RW 
IDAABF 
IDAAIBF 
IDAFRBA 


IDAGWSGW 


IDA019RX 
IDAGETWS 
IDARELWS 
IDARXBD 
IDAO19RY 


IDA019RZ 


IDAEXCL 
IDAFREEB 


IDAGNFL 


Component 
RM 
RM 
RM 


RM 
RM 


RM 
RM 
RM 
RM 
RM 
RM 
RM 
RM 
RM 


RM 
RM 
RM 
RM 
RM 
RM 
RM 
RM 


RM 
RM 


RM 


Method of 
Operation 
Diagrams 

BK1, BK2 
BK1, BK2 


BN1, BN3 


BO1, BO2 


BC, BD, BJ, 
BO1 


BJ, BOI 
BH2, BI 
BH1, BH2 
BH1, BH2 
BE, BF, BH1 
BC, BD 


BC, BD, BE, 
BH1, BI, BR 


BB1 


BD 


BH4 


BN3, BS1, BS2, 
BS4 


BQ 


BP1, BP2, BP3, 
BS1, BS2, DA1 


BC, BS1, BS2, 
BS4 


BC, BD, BE, 
BGI1, BGS, BH3, 
BH4, BH5, BM, 
BN1, BN2, BN3, 
BO1, BO2, BS1 


BG3, BH3, BH8 


Organization 
Figures 


31 


20, 21, 24, 
25, 26, 27, 
35, 38 


35 
23, 29, 39 


23, 35 
24, 25 
24, 25 
24, 25 
24 

20, 21 


37 


28 

21 

38 

38 

28, 35, 38 
38 

22, 38 


38 
36 


38 


38 


38 


20; 215-22; 
23, 24, 26, 
27, 28, 30, 
33, 34, 35, 
38 


29, 30, 33, 
34, 38 


Directory 273 


Module Directory 


Module 
Name 


IDA019RZ 


IDAO19R1 


IDA019R2 


IDA019R4 


IDAO019R5 


IDAO019R8 


IDA019SA 


IDA019SB 


IDA019SF 
IDA019S1 


Descriptive 
Name 


(Continued) 


Decode and Validate 


Buffer Management, Part 1 


Keyed/ Addressed Request Driver 


I/O-Error Analysis 


Control-Interval Processing 


Control-Interval Initialization—Create 
Entry-Sequenced Data Set 


Dynamically Build Channel Program Area 
for Shared Resources 


Control-Area Split-Spanned Records 


Improved Control-Interval Processing Driver 


274 OS/VS2 Virtual Storage Access Method (VSAM) Logic 


External 
Procedure 
Names 


IDAGNNFL 


IDAGNXT 


IDAGRB 


IDAGWSEG 
IDAMRKBF 
IDASBF 


IDASCHBF 
IDAWAIT 
IDAWRBFR 


IDAWRTBR 


IDAO19R1 


IDA019R2 


IDA019R4 


IDA019R5 


IDADRQ 


IDAEOVIF 


IDAERROR 


IDAEXEX 


IDAEXITR 


IDARSTRT 
IDA019R8 


IDA019SA 


IDA019SB 


IDA019SF 
IDA019S1 


Component 


RM 


RM 


RM 


RM 
RM 


RM 
RM 
RM 


RM 


RM 


RM 


RM 


RM 


RM 


RM 


RM 
RM 


RM 
RM 


RM 


RM 
RM 


Method of 
Operation 
Diagrams 


BE, BF, BG1, 
BG4, BH4, BHS5, 
BN2, BO1 


BC, BD, BH4, 
BN1, BO! 


BC, BE, BH1, 
BH3, BH4, BHS5, 
BH9, BH10, BJ, 
BM, BN1, BO1, 
BS2, BS3 


BE, BHS, BK1, 
BN1, BN2 


BS2, BS3, BS4 


BE, BG2, BH3, 
BH4, BHS, BH8, 
BH9, BK1, BK2, 
BN2, BN3, BO1, 
BO2 


AD7, BB1, BK1, 
BK2, BL 


BS1, BS2, BS3, 
DAI 


BC, BD, BE, 
BF, BH1, BH3, 
BQ, BR 


BB3, BK1, BL 


BP1, BP3, BS2, 
DAI 


BE, BG?2, BN2, 
BO1, DAI, DA2, 
DA4 


BK1, BL 


BM, BN1, BN2 
BN3 


BE, BF, BG1, 
BG2, BG3, BK2 


BH4 
BN1, BN3 


Program 


Organization 


Figures 


24, 26, 27, 
38, 35, 38 


20, 21, 22, 
28, 35, 38 


21,22, 23, 
27, 28, 33, 
34, 38 


38 
38 


22, 23, 27, 
28, 35, 38 


22, 38 


20, 24, 25, 
26, 27, 28, 
32, 35, 38 


12, 14, 20, 
21, 23, 24, 
35, 36 


38 


20, 21, 22, 
24, 25, 36, 
37 


38 


24, 35, 38, 
40 


26, 28, 29, 
34, 40 


38 


26, 29, 30 


28 


/ 


Module Directory 


Module 
Name 


IDA019S3 


IDA0192A 


IDA0192B 


IDA0192C 


IDA0192D 


IDA0192F 


IDA0192G 
IDA0192] 
IDA0192M 
IDA0192P 


IDA0192S 


IDA0192V 


IDA0192W 


IDA0192Y 


IDA0192Z 
IDA0195A 
IDA0200B 


IDA0200S 
IDA0200T 


IDA0231B 
IDA0231T 
IDA0557A 
IDA121A2 


IDAI21A3 


IDA121A4 


IDA121A5 
IDA121A6 
IDA121CV 


Descriptive 
Name 


Improved Control-Interval Processing—I/O 
Management 


VSAM Open String 


Open a Cluster 
Catalog Interface 


Stage/Destage (ACQUIRE/RELINQUISH) 


Open Base Cluster, Path, and Upgrade 
Alternate Index 


Data-Space Security Verification 
ISAM Interface: Open Processing 
Virtual-Storage Manager 


VSAM Open/Close/EOV: Problem 
Determination 


VSAM Open/Close/EOV: SMF Record Build 


Volume Mount and Verify 


Channel-Program-Area Build 


String Build and Shared-Resource 
Processor 


Control-Block Build 
VSAM SNAP Format Routine 


Close a Cluster 


ISAM Interface: Close Processing 
VSAM Close String 


Close (TYPE=T) a Cluster 
VSAM Close (TYPE=T) String 
VSAM End of Volume 


Actual Block Processor 


Normal End Appendage 


Abnormal End Appendage 


Asynchronous Routine 
Purge Routine 


Communication Vector Table IEZABP) 


External 
Procedure 
Names 


IDA019S3 


IDA0192A 


IDA0192B 
IDA0192C 


IDA0192D 


IDA0192F 


IDA0192G 
IDA0192I 
IDA0192M 
IDA0192P 


IDA0192S 


IDA0192V 


IDA0192W 
IDA0192Y 


IDA0192Z 
IDAO195A 
IDA0200B 


IDA0200S 
IDA0200T 


IDA0231B 
IDA0231T 
IDA0557A 
IDA121A2 
IDA121F2 
IDA121A3 
F3FRR 
IDA121F3 
IDA121A4 
IDA121F4 
IDA121A5 
IDA121A6 


Component 


RM 


O 


O 
O 


O/C/EOV 


O 


O 
II 
O/C/EOV 
O 


O 


O 


O 
O/C 


O 
O/C/EOV 
C 


II 


EOV 
IOM 
IOM 
IOM 
IOM 
IOM 
IOM 
IOM 
IOM 
IOM 
IOM 


Method of 


Operation 
Diagrams 


BN1, BN3 


AC1, AC2, AC7, 


AG 
AC4, ALI 


AC2, AC4, AD6 
AD7, AE2, AL1, 


BT1 


AD6, AE2, BT2 


AC3, AC4, ACS, 


AC6 


AC1, AC7 
AL2 


AD5, AD6, AE2, 


AH3 


AC7, AD6, AE2 


AC3, BT1 


AC1, AC4 


AC1, AC4, ACS, 
AD5, AF1, AH3, 


AL1, AL2 
AC4, AL1 


AD1, AD3, AD4, 


AD6 
AD1, AD7 


AD1, AD2, AD3, 
AD4, AD5, AD7 


AEI, AE2 
AE1, AE2 
BT 1, BT2 


DA2, DA3, DA4 


DA3 
DA4 
DA4 
DA4 
DAS 
DAS 
DA4, DAS 


Program 
Organization 
Figures 


5, 6, 7, 
11 


8, 18 


5, 6, 8, 
12, 14, 15, 
18, 39 


8, 12, 14, 
18, 39 


8,18 


15 
7 
8, 10, 16 


8, 12, 14, 
18, 39 


8, 12, 14, 
39 


5, 8,18, 
39 


8, 10 


8, 10, 12, 
14, 16, 18 


8, 18 


12 


11 
12 


14 
14 
40 
40 
41 
41 
41 
41 
41 
41 


Directory 275 


Module Directory 


Module 
Name 


TEFVAMP 
IFG0192A 


IFGO192Y 
IGC121 


External 
Descriptive Procedure 
Name Names 
AMP Parameter Interpreter IEFNB902 
VSAM Open/Close/EOV String Load IFG0192A 
(Interface between OS/VS and VSAM O/C/EOV) 
BLDVRP/DLVRP Load Routine IFGO192Y 
Supervisor-State I/O Driver IGC121 

IDA121F1 
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Component 


0/C/EOV 


0/C/EOV 
IOM 
IOM 


Method of 
Operation 
Diagrams 


AF 


DAI, DA2, DA3 
DA2 


Program 
Organization 
Figures 


5, 7, 8, 
11, 12, 14 


10, 16 
40 
40 


J 





External Procedure Directory 


Procedure 
Name 


F3FRR 
IDAABF 


IDAADSEG 


IDAADVPH 
IDAAIBF 
IDAAQR 


IDACHKKR 
IDACI96C 
IDACKRAI1 


IDADARTV 
IDADRQ 


IDAENDRQ 


IDAEOVIF 


IDAER 


IDAERROR 
IDAEXCL 
IDAEXEX 
IDAEXITR 
IDAFRBA 


IDAFREEB 


IDAGETWS 
IDAGNFL 


IDAGNNFL 


IDAGNXT 


IDAGRB 


IDAGWSEG 


IDAGWSGW 


Module 
Name 


IDA121A3 
IDA019RW 


IDAO19RS 


IDA021RV 
IDA019RW 
IDA019RN 


IDA019RM 
IDAOI96C 
IDACKRAI 


IDA019RT 
IDA019R5 


IDAO019RP 


IDAO19R5 


IDA019RN 


IDA019R5 
IDA019RZ 
IDA019R5 
IDA019R5 
IDA019RW 


IDA019RZ 


IDA019RX 
IDA019RZ 


IDA019RZ 


IDA019RZ 


IDA019RZ 


IDA019RZ 
IDA019RW 


Descriptive 


Name 
Functional Recovery Routine (of IDA121F3) 


Buffer Management: Add Buffer to 
Placeholder (PLH) 


Insert a Spanned-Record-Segment Entry 
into a Sequence-Set Record 


Advance Placeholder Backwards 
Add Insert Buffer to Chain 


Split Index Record: Assign RBA to 
the Index Record 


Check Key for Proper Key Range 
Free VSAM Checkpoint/Restart Storage 
Checkpoint/Restart: ESTAE 


Retrieve a Spanned Record 


Data Insert: Defer the Request until 
the Device is Available 


ENDREQ Request 


Data Insert: Interface to VSAM 
End of Volume 


Index Create: Erase Dummy Entry from 
the Index Record 


Determine Which Exit to Take 
Exclusive Control 

Exit to User Exception Routine 
Exit to User Routine 


Buffer Management: Determine next RBA for 
Sequential Processing 


Free a Buffer 


Get Working Storage 
Buffer Management: Obtain an Empty Buffer 


Buffer Management: Obtain Next Empty 
Buffer for the Placeholder 


Buffer Management: Obtain Next Buffer in 
Sequence 


Buffer Management: Obtain the Buffer That 
Contains the Specified RBA 


Get a Work Segment (for Shared Resources) 
Get a Work Segment 


Method of 
Operation 


DA4 
BH4 


BH1, BH2 


BD 


BG3, BG4, BG5, 
BG8, BH9 


AJ, AL2 


AJ, AK, AL1, 
AM 


BC, BD 


BP1, BP3, BS2, 
DAI 


BK1, BK2 


BE, BG2, BN2, 
BO1, DAI, DA2, 
DA4 


BG5 


BK1, BL 


BN3, BS1, BS2, 
BS4 


BC, BD, BE, 
BG1, BGS, BH3, 
BH4, BHS, BM, 
BN1, BN2, BN3, 
BO1, BO2, BS1 


BG3, BH3, BH8 


BE, BF, BG1, 
BG4, BH4, BHS, 
BN2, BO1 

BC, BD, BH4, 
BN1, BO1 

BC, BE, BH1, 
BH3, BH4, BHS5, 
BH9, BH10, BJ, 
BM, BN1, BOI, 
BS2, BS3 


Program 
Organization 
Figures 


41 
28, 35, 38 


24, 25 


21 
38 


29, 30, 33, 
34 


17, 18 
17, 18 


20, 21 


24, 35, 38, 
40 


31 


26, 28, 29, 
34, 40 


30 


38 
38 


22, 38 


20, 21, 22, 
23, 24, 25, 
27, 28, 30, 
33, 34, 35, 
38 


29, 30, 33, 
34, 38 


24, 26, 27, 
28, 35, 38 


20, 21, 23, 
28, 35, 38 


21, 22, 23, 
27, 28, 33, 
34, 38 


38 
38 
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External Procedure Directory 


Procedure 
Name 


IDAHLINS 
IDAICIA1 


IDAIIFBF 
IDAIPM1 
IDAIIPM2 
IDAIIPM3 
IDAITSM1 
IDAIST 


IDAIVIXB 


IDAJRNSR 


IDAMRKBF 
IDAMVSEG 
IDANEWRD 


IDAOCEAI1 


IDAOCEA2 
IDAOCEA4 


IDAR 


IDARELWS 


IDAREPOS 


IDARRDRL 


IDARSTRT 
IDARVRS1 
IDARXBD 
IDASBF 


IDASCHBF 
IDASPACE 


IDASPNPT 


IDATJXIT 


IDAWAIT 


IDAWR 


Module 
Name 


IDAO19RI 
IDAICIA1 


IDAIIFBF 
IDAIIPM1 
IDAITPM2 
IDAITPM3 
IDAIISM1 
IDA019RG 


IDA019RH 


IDA019RT 
IDA019RZ 
IDA019RS 
IDAO19RI 
IDAOCEA1 


IDAOCEA2 
IDAOCEA4 


IDAO19RJ 

IDA019RX 
IDA019RE 
IDA019RR 


IDA019RS5 

IDA019RV 
IDA019RX 
IDA019RZ 


IDA019RZ 
IDA019RH 


IDA019RT 


IDA019RP 


IDA019RZ 


IDA019RJ 


Descriptive 
Name 


Insert Entry into Index-Set Record 


ISAM Interface: Data-Set Management 
Recovery Routine 


ISAM Interface: FREEDBUF Processing 

ISAM Interface: Load-Mode Processing 

ISAM Interface: QISAM Scan-Mode Processing 
ISAM Interface: BISAM Processing 

ISAM Interface: SYNAD Processing 


Index Create: Insert Entry into Index 
Record 


Index Insert: Invalidate Buffers 
Containing a Copy of the Modified 
Index Record 


Journal a Spanned-Record Segment 
Mark a Buffer 

Move a Segment 

Initialize a New Sequence-Set Record 


Data-Set Management Recovery Routine 
(Force Close Executor) 


Task Close Executor 
BLDVRP/DLVRP ESTAE Routine 
Split Index Record: Read the Record 
Release Working Storage 
Reposition Placeholder 


Direct Record Locate for 
Relative Record 


Restart 
Order Buffers 
Increase Working Buffer Length 


Buffer Management: Remove Buffers from 
Placeholder 


Share a Buffer 


Check an Index Record to Ensure 
It Can Be Split 


Make an INDEX Entry for a Spanned- 
Record Segment 


Control-Interval Request: Take the 
Journal Exit 


Buffer Management: Wait for Completion 
of I/O Operations 


Split Index Record: Write the Index 
Record 
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Method of 
Operation 
Diagrams 


BH4 
AG 


BU2 
BUI 
BUI 
BU2 
BU2 


BG3, BG4, BGS, 
BH9 


BH1, BH2 
BH4 
AF, AG 


AH1, AH2, AH3 
AF, AG 
BG5, BH9, BH10 


BE, BHS, BK1, 
BN1, BN2 


BN1, BN3 


BS2, BS3, BS4 


BG4, BGS, BH10 


Organization 
Figures 


28 
11 


29, 30 


38 
24, 25 
28 


8, 10, 11, 
12, 16, 39 


8, 39 
10, 16 
30 


23, 35 


38 


22,25; 21; 
28, 35, 38 


20, 21, 24, 
25, 26, 27, 
35, 38 


22, 38 


30, 31 


) 





External Procedure Directory 


Procedure 
Name 


IDAWRBFR 


IDAWRTBF 
IDAXGPLH 
IDAOA05B 
IDAOCO5B 


IDAOCO06C 
IDAOI96C 
IDA019C1 
IDA019RA 


IDA019RB 


IDA019RC 


IDA019RD 


IDA019RE 


IDA019RF 


IDA019RG 


IDA019RH 


IDAO19RI 


IDAO19RJ 


IDA019RK 


IDAO19RL 


IDA019RM 


IDA019RN 
IDA019RO 
IDA019RP 
IDA019RQ 
IDA019RR 


IDA019RS 
IDA019RT 


Module 
Name 


IDA019RZ 


IDA019RZ 
IDA019RU 
IDAOA05B 
IDAOCO5B 


IDA0C06C 
IDAOL96C 
IDA019C1 
IDAO1I9RA 


IDA019RB 


IDA019RC 


IDA019RD 


IDA019RE 


IDAO19RF 


IDA019RG 


IDA019RH 


IDAOI9RI 


IDA019RJ 


IDA019RK 


IDAO19RL 


IDA019RM 


IDA019RN 
IDA019RO 
IDAO019RP 
IDA019RQ 
IDA019RR 


IDA019RS 
IDA019RT 


Descriptive 
Name 


Buffer Management: Write the Buffer 


Write a Buffer 
Get a Placeholder 
Checkpoint/Restart: Restart 


Checkpoint/Restart: SSCR and Initial 
DEB Processing 


Checkpoint/Restart: Checkpoint 
Checkpoint/Restart: SSCR Build and Cleanup 
Control Block Manipulation 


Direct Record Locate 


Index Search 


Search Compressed Index Block 


DD DUMMY Processing 


Control-Interval Split 


Control-Area Split 


Index Create 


Index Insert 


Index Upgrade 


Split Index Record 


Preformat 


Data Modify 


Data Insert 


Indexing Subroutines 

Verify 

ENDREQ and JRNAD 
Relative Record Subroutines 


Relative Record Driver 


Spanned Record Data Modify 
Spanned Record Data Insert 


Method of 


Operation 
Diagrams 


BE, BG2, BH3, 
BH4, BHS5, BH8, 
BH9, BK1, BK2, 
BN72, BN3, BOI, 
BO2 


BBI 
AJ, AL1, AL2 
AK 


Al, AJ 
AJ 
CA, CB1, CB2 


BC, BE, BHI, 
BJ 


BC, BH1, BH8, 
BJ, BM 


BC, BH1, BH2, 
BH6, BI, BJ, 
BM, BS4 


BH1, BH3, BH7 


BH1, BH2, BH3, 
BH4, BHS 


BG1, BG2, BG3, 
BG4, BGS, BK2 


BH3, BH6, BH7, 
BH8 


BH4, BH5, BH7, 
BH8, BH9 


BH4, BH7, BH8, 
BH9, BH10 


BG2, BH4, BH8, 
BH9, BK2, BN2, 
BOI 


BH2, BI 


BE, BF, BH1, 
BH2, BH3 


BM 
BK1, BK2 
BO1, BO2 


BC, BD, BJ, 
BOI 


BH2, BI 
BE, BF, BH1 


Program 
Organization 
Figures 


20, 24, 25, 
26, 27, 28, 
32, 35, 38 


18 
18 


17 
17 


20, 21, 22, 
24 


22, 34 


22, 24, 25, 
32 


24, 25, 27, 
28, 32 


24, 25, 26, 
27, 33, 34 


26, 29, 30, 
31 


27, 32, 33, 
34 


28, 33, 34 


34 


24, 26, 28, 
29 


24, 25 


24, 25, 26, 
27, 28, 40 


35 
23, 25, 35 


24, 25 
24 
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External Procedure Directory 


Procedure 
Name 


IDA019RU 


IDAO019RV 
IDA019RW 
IDA019RX 
IDAOI9RY 


IDA019RZ 


IDAO19R1 


IDA019R2 


IDA019R3 


IDA019R4 


IDAO19R5 


IDA019R8 


IDA019SA 


IDA019SB 


IDA019SF 
IDA019S1 


IDA019S3 


IDA0192A 


IDA0192B 


IDA0192C 


IDA0192D 


IDA0192F 


IDA0192G 
IDA0192I 
IDA0192M 
IDA0192P 


Module 
Name 


IDA019RU 


IDA019RV 
IDA019RW 
IDA019RX 
IDAOI9RY 


IDA019RZ 


IDAO19R1 


IDA019R2 


IDAM19R3 


IDA019R4 


IDA019R5 


IDA019R8 


IDA019SA 


IDA019SB 


IDAO19SF 
IDA019S1 


IDA019S3 


IDA0192A 


IDA0192B 


IDA0192C 


IDA0192D 


IDA0192F 


IDA0192G 
IDA0192I 
IDA0192M 
IDA0192P 


Descriptive 
Name 


Alternate-Index Upgrade Driver 


Locate Previous Sequence-Set Record 
Buffer Management, Part 2 
Path Processing Driver 


Shared Resources Buffer Management 
Buffer Management Interface 


Record Management: Request Decode and 
Validate 


Buffer Management, Part 1 


I/O Management: Problem-State I/O Driver 


Keyed/Addressed Request Driver 


I/O Error Analyais 


Control-Interval Processing 


Control-Interval Initialization-Create 
Entry-Sequenced Data Set 


Dynamically Build Channel Program 
Area for Shared Resources 


Control-Area Split-Spanned Records 


Improved Control-Interval Processing 
Driver 


Improved Control-Interval Processing- 
I/O Management 


VSAM Open String 


Open a Cluster 
VSAM Open/Close: Catalog Interface 


Stage/Destage (ACQUIRE/RELINQUISH) 


Open Base Cluster, Path, and Upgrade 
Alternate Index 


Data-Space Security Verification 

ISAM Interface: Open Processing 

Virtual Storage Manager 

VSAM Open/Close/EOV: Problem Determination 
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Method of 
Operation 
Diagrams 


BC, BD, BE, 
BH1, BI, BR 


BQ 


BP1, BP2, BP3, 
BS1, BS2, DA! 


BC, BS1, BS2, 
BS4 


AD7, BB1, BK, 
BK2, BL 


BS1, BS2, BS3, 
DAI 


BG1, BS], BS2, 
BS3, BS4, DA1, 
DA2, DA3 


BC, BD, BE, 
BF, BH1, BH3, 
BQ, BR 


BB3, BK1, BL 


BM, BN1, BN2, 
BN3 


BE, BF, BGI, 
BG2, BG3, BK2 


BH4 
BN1, BN3 


BN1, BN3 


AC1, AC2, AC7, 
AG 


AC4, AL1 


AC2, AC4, AD6, 
AD7, AE2, AL1, 
BT1 


AD6, AE2, BT2 


AC3, AC4, ACS, 
AC6 


AL2 
AC1, AC7 


ADS5, AD6, AE2, 
AH3 


Program 
Organization 
Figures 


37 


28 
38 
36 
38 


38 


12, 14, 20, 
21, 23, 24, 
35, 36 


38 


20, 22, 38, 
40 


20, 21, 22, 
24, 25, 36, 
37 


38 


26, 29, 30 


28 


50,7 
11 


8, 18 


5, 6, 8, 
12, 14, 15, 
18, 39 


8, 12, 14, 
18, 39 


8, 18 


15 
7 
8, 10, 16 


8, 12, 14, 
18, 39 


External Procedure Directory 


Procedure 
Name 


IDA0192S 


IDA0192V 
IDA0192W 
IDA0192Y 


IDA0192Z 
IDA0200B 


IDA0200S 
IDA0200T 


IDA0231B 
IDA0231T 
IDA0557A 
IDA121A2 
IDA121A3 
IDA121A4 
IDA121A5 
IDA121A6 
IDA121F1 

IDA121F2 

IDA121F3 

IDA121F4 
IEFNB902 
IFG0192A 


IFG0192Y 
IGC121 
IMDUSRF9 
PIODFRR 


Module 
Name 


IDA0192S 


IDA0192V 
IDA0192W 
IDA0192Y 


IDA0192Z 
IDA0200B 


IDA0200S 
IDA0200T 


IDA0231B 
IDA0231T 
IDA0557A 
IDA121A2 
IDA121A3 
IDA121A4 
IDA121A5 
IDA121A6 
IGC121 

IDA121A2 
IDA121A3 
IDA121A4 
IEFVAMP 
IFGO192A 


IFGO0192Y 
1GC121 


AMDUSRF9 


IDAM19R3 


Descriptive 
Name 


VSAM Open/Close/EOV: SMF Record Build 


Volume Mount and Verify 
Channel-Program-Area Build 


String Build and Shared-Resource 
Processor 


Control Block Build 


Close a Cluster 


ISAM Interface: Close Processing 
VSAM Close String 


Close (TYPE=T) a Cluster 

VSAM Close (TYPE=T) String 

VSAM End of Volume 

I/O Management: Actual Block Processor 
I/O Management: Normal End Appendage 
I/O Management: Abnormal End appendage 
I/O Management: Asynchronous Routine 
I/O Management: Purge Routine 
Functional Recovery Routine 

Functional Recovery Routine 

Functional Recovery Routine 

Functional Recovery Routine 

AMP Parameter Interpreter 


VSAM Open/Close/EOV String Load 
(Interface between OS/VS and VSAM O/C/EOV) 


BLDVRP/DLVRP Load Routine 
I/O Management: Supervisor State I/O Driver 
IMDPRDMP Format Appendage 


Functional Recovery Routine 


Method of 
Operation 
Diagrams 


AC7, AD6, AE2 


AC3, BT1 
AC1, AC4 


AC1, AC4, ACS, 
AD5, AF1, AH3, 


AL1, AL2 
AC4, AL1 


AD1, AD3, AD4, 


AD6 
AD1, AD7 


AD1, AD2, AD3 
AD4, AD5, AD7 


AE1, AE2 
AE1, AE2 
BT1, BT2 


DA2, DA3, DA4 


DA4 
DA5 
DA4, DAS 
DA2 
DA3 
DA4 
DAS 


AF 


DA1, DA2, DA3 


DAI 


Program 
Organization 
Figures 


8, 12, 14, 
39 


5, 8, 18, 39 
8, 10 


8, 10, 12, 
14, 16, 18 


8, 18 
12 


11 
12 


14 
14 
40 
41 
41 
41 


Dy ty Os 
11, 12,14 


10, 16 
40 


40 
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Module Packaging 


Most VSAM modules reside in pageable virtual storage; some 
I/O-Management modules reside in the nucleus. The following table lists the 
VSAM load modules and transients that are resident in the SVCLIB or 
LPALIB library or in the nucleus. Those in the libraries are loaded into the 
pageable supervisor or link-pack area by nucleus initialization (NIP) at initial 
program load (IPL). Those in the nucleus are link-edited there when the 
system is generated. 


Name Description 

Record Management 

IDAO19L1 Main Record Management 

IDAO19L.2 Improved Control-Interval 
Processing 

IDAO19RS Spanned Record Data Modify 

IDA019RT Spanned Record Data Insert 


Open/Close/End of Volume and Checkpoint /Restart 


IDA0192A Open/Close/End of Volume 

ISAM Interface 

IDAIIFBF FREEDBUF 

IDAIIPM1 QISAM Load 

IDAIIPM2 QISAM Scan 

IDAIIPM3 BISAM 

IDAIISM1 SYNAD 

I/O Management 

IDAM19R3 Problem-State I/O Driver 

IDA121A2 Actual Block Processor 

IDA121A3 Normal End Appendage 

IDA121A4 Abnormal End Appendage 

IDA121A5 Asynchronous Routine 

IDA121A6 Purge Routine 

IDA121CV Communication Vector Table 
(IEZABP) 

IGC121 Supervisor-State I/O Driver 
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VSAM Modules 


IDAM19R3, IDAOI9RA, IDAO19RB, 
IDA019RC, IDAOI9RD, IDAOI9RE, 
IDA019RF, IDA019RG, IDA019RH, 
IDA019RI, IDA019RJ, IDAOI9RK, 
IDAO19RL, IDA019RM, IDAOISRN, 
IDA019RO, IDAO19RP, IDA019RQ, 
IDA019RR, IDA019RU, IDAOIORV, 
IDA019RW, IDA019RX, IDAO19RY, 
IDA019RZ, IDA019R1, IDA019R2, 
IDA019R4, IDA019R5, IDAO19R8, 
IDA019SA, IDA019SB, IDA019SF 


IDA019S1, IDA019S3 


IDA019RS 
IDA019RT 


IDACKRA1,IDA0A05B, IDAOCOS5B, 
IDAOCO06C, IDAOI96C, IDA0192A, 
IDA0192B, IDA0192C, IDA0192D, 
IDA0192F, IDA0192G, IDA0192I, 
IDA0192M, IDA0192P, IDA0192S, 
IDA0192V, IDA0192W, IDA0192Y, 
IDA0192Z, IDA0200B, IDA0200S, 
IDA0200T, IDA0231B, IDA0231T, 
IDA0557A 


IDAIIFBF 
IDAIIPM1 
IDAIIPM2 
IDAIIPM3 
IDAITSM1 


IDAM19R3 (Packaged in Main Record 
Management IDA019L1) 


IDA121A2 (Nucleus) 
IDA121A3 (Nucleus) 
IDA121A4 (Nucleus) 
IDA121A5 

IDA121A6 (Nucleus) 
IDA121CV (Nucleus) 


IGC121 (Nucleus) 


Name Description 

Control Block Manipulation 

IDA019C1 Control Block Manipulation 

VSAM Transient Routine 

IFG0192A VSAM Open/Close/End of 
Volume Loader 

Miscellaneous Routines 

AMDUSRF9 IMDPRDMP format appendage 

IDA0195A VSAM SNAP format routine 

IEFVAMP AMP parameter interpreter 


VSAM Modules 


IDA019C1 


IDAICIA1, IDAOCEA1, IDAOCEA2, 
IDAOCEA4, IFG0192A 


AMDUSRF9 


IDA0195A 
TEFVAMP 
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DATA AREAS 


VSAM Data Set Format 


VSAM Record 


Control Interval 


‘‘Data Areas’ describes a VSAM data set and index and their record formats. 
‘“‘Data Areas’”’ also describes each VSAM control block and shows the 
relationships between VSAM control blocks. OS/VS2 VSAM Cross 
Reference (microfiche) has a “Symbol Where Used Report” that lists 
alphabetically all the symbols used in VSAM modules, along with all the 
modules that use them. 


A VSAM data set is a collection of records grouped into control intervals. 
Control intervals are grouped into larger units called control areas. The 
VSAM stored record, control interval, and control area are described in the 
sections that follow. 


VSAM records are ordered according to key, in the case of a key-sequenced 
data set, according to when the records were stored, in the case of an 
entry-sequenced data set, or according to record numbers that serve as keys, 
in the case of a relative record data set. 


Data records are put in the low-address portion of the control interval. 
Control information about each data record is put in the high-address portion 
of the control interval. The combination of a data record and its control 
information, though they are not physically adjacent, is called a stored record. 


In a key-sequenced or entry-sequenced data set, records can be variable in 
length and can span control intervals. Each segment of a spanned record is 
stored in its own control interval. 


A control interval is a continuous area of auxiliary storage that VSAM uses 
for storing records. The control interval is the unit of information that VSAM 
transfers between virtual and auxiliary storage. 


The length of each control interval is an integral multiple of block size. The 
size of a control interval is determined by the system from the size of the 
records, user-specified minimum buffer size, device characteristics, and the 
user-specified percentage of free space. The user can specify the size of the 
control interval, but it must be within limits acceptable to VSAM. 


Figure 42 shows the format of a control interval. 
When a data set is created, records are put into control intervals. 


For an entry-sequenced data set, records are ordered according to when they 
were stored in the data set. The first record to be stored, therefore, has the 
lowest RBA. A control interval is filled until there is insufficient space in it for 
the next record. Records are always added at the end of an entry-sequenced 
data set. 


For a key-sequenced data set, records are ordered according to key. Records 
of a key-sequenced data set are put into control intervals; the percentage of 
free space specified is reserved in each control interval and in each control 
area for use by records to be added to the data set. As records are added to 
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Free Space 





Figure 42. Control Interval Format 


the data set, records that have higher keys are moved to higher RBA 
locations; the free space within the control interval is reduced. 


Distributed free space is used to simplify the insertion of records. If there is 
enough free space in the control interval to accommodate the record to be 
inserted, higher-keyed records are moved within the control interval to keep 
the records in key sequence. 


If the space needed for directly inserted records is greater than the amount of 
free space available in a control interval, the control interval is split: VSAM 
moves some of the stored records (data records and their control information) 
to an empty control interval in the same control area. For mass insert 
(sequential insert at the end of a control interval), the percentage of free 
space defined by the user is maintained. 


When a control interval has reached its defined packing factor, a new control 
interval is obtained. No data is moved. 


Note that it is possible for the physical sequence of records to be different 
from their key sequence after control-interval splits. The sequence will be 
according to key in each control interval, but the control intervals involved in 
the split need not be adjacent. Thus, it is possible to have 1-2-3, 4-5-6, 9-10, 
7-8 in each of four control intervals. The sequence-set index records, 
however, reflect the key sequence. 


For a relative record data set, records are ordered according to their relative 
record number. Each control interval has as many fixed-length slots as will fit 
(and allow room for control information). If each control interval has ten 
slots, the first control interval has slots for relative records 1 through 10, the 
second for 11 through 20, and so on. 
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RDF—Record Definition Field 


The record definition field (RDF) describes a record, record slot, or record 
segment within the control interval. RDFs are put into the control interval 
right to left so that the rightmost RDF describes the leftmost data record. The 


format of the RDF is: 
Bytes and 
Offset Bit Pattern 
0(0) 1 
scales 
» Pra XX 
1(1) 2 


Description 
Control field: 


Indicates whether there is (1) or isn’t (0) a paired RDF to 

the left of this RDF. 

Indicates whether the record spans control intervals: 

00 No. 

01 Yes—this is the first segment. 

10 Yes—this is the last segment. 

11 Yes—this is an intermediate segment. 

Indicates what the 2-byte binary number that follows this 

control field gives: 

0 The length of the record, segment, or slot described by 
this RDF. 

1 The number of consecutive unspanned records of the 
same length, or the update number of the segment of a 
spanned record. 

For a relative record data set, indicates whether the slot 

described by this RDF does (0) or doesn’t (1) contain a 

record. 

Reserved. 


Binary number: 

e When bit 4 in the control field is 0, gives the length of 
the record, segment, or slot described by this RDF. 

e When bit 4 in the control field is 1 and bits 2 and 3 are 
0, gives the number of consecutive records of the same 
length. 

e When bit 4 in the control field is 1 and bits 2 and 3 
aren't 0, gives the update number of the segment 
described by this RDF. 
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CIDF—Control Interval Definition Field 


Control Area 


Index Format 


In an entry-sequenced data set, when there are unused control intervals 
beyond the last one that contains data, the first of the unused control 
intervals contains a CIDF filled with Os. In a key-sequenced or relative record 
data set, or a key-range portion of a key-sequenced data set, the first control 
interval in the first unused control area (if any) contains a CIDF filled with 
Os. A control interval with such a CIDF contains no data or unused space. 


The control interval definition field (CIDF) describes the control interval. 
The format of the CIDF is: 


Bytes and 
Offset Bit Pattern Description 


0(0) 2 The displacement from the beginning of the control interval to 
the beginning of the unused space, or, if there is no unused 
space, to the beginning of the control information. This number 
is equal to the length of the data (records, record slots, or record 
segment). In a control interval without data, the number is 0. 


2(2) 2 The length of the unused space. This number is equal to the 
length of the control interval, minus the length of the control 
information, minus the 2-byte number in the preceding field. Ina 
control interval without data (records, record slots, or record 
segment), the number is the length of the control interval, minus 
4 (the length of the CIDF—there are no RDFs). In a control 
interval without unused space, the number is 0. 


A control area consists of control intervals; the number of control intervals in 
a control area is determined by VSAM. The control area is the amount of 
space that VSAM preformats so that data integrity is ensured for records 
added to a data set. 


Control areas are also used to simplify and localize the movement of records 
when records are inserted in a key-sequenced data set. If an insertion requires 
a free control interval and there isn’t one, a control-area split results. VSAM 
establishes a new control area and moves the contents of approximately half 
of the full control area to free control intervals in the new control area. The 
new records, as their keys dictate, are then inserted into one of the two 
control areas. 


There are two types of indexes in VSAM: the prime index of a 
key-sequenced data set, and alternate indexes of either a key-sequenced or 
an entry-sequenced data set. 


A key-sequenced data set is a cluster composed of a data component, which 
contains the control intervals that contain data records, and an index 
component, which contains the control intervals that contain the records of 
the prime index. 


An alternate index is itself a key-sequenced data set. Its data component 
contains index records that give the location of data records within its base 
cluster (the key-sequenced or entry-sequenced data set for which it is the 
alternate index). 
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Format of Records in a Prime Index 


The format of records in the index component of a key-sequenced cluster is 
fully compatible with the format of VSAM data records; that is, index 
records, regardless of their level within the index, are treated by 
Record-Management modules in the same way that any other VSAM record 
is treated. Each index record and associated control information resides in an 
index control interval. Figure 43 shows the basic format of an index control 
interval. The RDF and CIDF fields are described under ‘‘Control Interval”’ 
earlier in this chapter. 


Control Information 


cM OF 


Index Record 





Figure 43. Index Control Interval Format 


Figure 44 shows an expansion of the record portion of the index control 
interval. 





Free Data- Index 
Control- Entries 
Interval 

Pointers 


Figure 44. Index Record Format 


The header portion of the index record contains, for example, the information 
required to insert index entries, to locate entries within the index record, and 
to convert pointers within entries to RBAs. The free data-control-interval 
pointers are used to locate data control intervals that have not yet been used; 
these entries exist only in sequence-set index records. Both the index entries 
and the free data-control-interval pointers are placed in the index record from 
right to left, as indicated in the figure. 


Index entries are grouped into sections. When an index entry is to be located, 
the search for it begins at the section level. The high-key entry of each section 
is examined to locate the section that contains the specified entry. VSAM 
determines the number of sections on the basis of the total number of entries 
within the index record. Figure 45 shows the index entry portion of the index 
record divided into sections. 
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Index Entries Index Entries Index Entries 





Figure 45. Index Entries Grouped into Sections 


The parts of an index record—header, free data-control-interval pointers, and 
entry sections—are described in the paragraphs that follow. 


Index Record Header 


The format of the index record header is: 


Index Record Header Format 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 2 IXHLL Length, in bytes, of the index record, 


including this field. Equals control-interval 
length minus 7. 


2 (2) 1 IXHFLPLN Length, in bytes, of the control information 
(the IBFLPF, IBFLPL, and IBFLP3 fields) in 
each index entry. 


3 (3) 1 IXHPTLS Length of the vertical pointers in this index 
record. In the sequence set, vertical pointers 
point to data control intervals; in the index 
set, they point to index control intervals in a : 
lower level of the index.! This field is used as } 
a mask for insert character (store character) ‘ 
under mask instructions that are used to 
access pointers. The value contained in this 
field specifies the length of these pointers, as 
follows: 


x‘Or’ 1-byte pointer 
X‘03’ 2-byte pointer 
X‘07’ 3-byte pointer 


4 (4) 4 IXHBRBA For a sequence-set index record, the RBA of 
a data control area that contains data to be 
referenced. This RBA and index-entry 
pointers are used together to calculate the 
4-byte RBA of another index record or of a 
data control interval. 


8 (8) 4 IXHHP Pointer to the logically next index record in 
this index level. (Horizontal pointer.) 

12 (C) 4 IXHXX Reserved (0). 

16 (10) 1 IXHLV Index level number. A sequence-set index is 


assigned a value of 1; the next higher-level 
index is assigned a value of 2; etc. 


17 (11) 1 IXHFLGS Reserved (0). 


18 (12) 2 IXHFSO Displacement from the beginning of this 
record to the space available for inserting 
index entries. For higher-level indexes, the 
entry space immediately follows the record 
header; for sequence-set indexes, the entry 
space follows the record header and free ) 
data-control-interval pointers. 
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Index Record Header Format 


Bytes and 
Offset Bit Patten Field Name Description 


20 (14) 2 IXHLEO Displacement from the beginning of this 
record to the last (high-key) entry in the 
index record.2 (The leftmost entry.) 


22 (16) 2 IXHSEO Displacement from the beginning of this 
record to the last (high-key) entry in the first 
section in the index record.2 (The leftmost 
entry in the first section. ) 

1 Pointers vary in length to conserve index space. For example, if the number of items to be referenced is less 


than 256, a one-byte pointer is used; if the number is greater than 256, a two-byte pointer is used; and if the 
number is greater than 65,536, a three-byte pointer is used. 


2 This displacement is to the IBFLPF (front-key compression count) byte of the entry, not to the beginning 
of the entry. 


Free-Data-Control-Interval Pointers 


Index Entries 


Index-Entry Sections 


Free data-control-interval pointers, which exist only in sequence-set index 
records, are used to calculate the RBAs of available data control intervals. 
The length of a pointer is specified in the record header. 


VSAM always uses the rightmost free data-control-interval pointer when a 
data control interval is needed. The value of the pointer is set to 0 when the 
control interval is used. As pointers are set to 0, the displacement to space 
that is available for index entries (contained in the record header) is adjusted 
by the length of the free data-control-interval pointer. In this way, space used 
by free data-control-interval pointers is made available for index entries when 
the pointers are no longer required. 


The format of an index entry is: 


Length 

(in Bytes) Field Name Description 

Variable IXKEY Key characters that determine the sequence of 
records in a key-sequenced data set. 

1 IBFLPF Front-key compression count, that is, the number of 
characters by which the beginning of the key has been 
compressed. 

1 IBFLPL Length of the IXKEY field. 

1-3 IBPLP3 Pointer to an index or data control interval. The 


length of the pointer is specified in the record header. 
The last (high key) index entry in each index level is a dummy entry: it 
contains no key characters and the IBFLPF and IBFLPL fields are set to 0. 
The pointer in this entry is used to calculate the RBA of the last control 


Each segment of a spanned record has its own entry in a sequence-set index 
record. Only the leftmost entry (the entry for the last segment) contains the 
IXKEY field. In all of the other entries, IBFLPF contains the spanned 
record’s key length, and IBFLPL contains 0. 


Index entries are grouped into sections. A section is defined by a 2-byte field 
that precedes the high-key index entry. This 2-byte field links a section with a 
higher-keyed section. This field contains the displacement from the IBFLPF 
field of the high-key entry in this section to the IBFLPF field of the high-key 
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entry in the next higher-key section. Figure 46 shows how these pointers 

work. Section 1 indicates the number of bytes between the high-key entry in 

section 1 and the high-key entry in section 2; section 2 indicates the number 

of bytes between the high-key entry in section 2 and the high-key entry in 

section 3; etc. J 


Figure 46. Index-Entry Section Pointers 


When the index is searched, the high key of each section is examined to locate 
the section that contains the specified entry. When the section that contains 
the entry is found, it is searched. 


When an index is originally built, the sections within a record usually contain 
the same number of entries. As index entries are added and deleted, however, 
the number of entries per section varies. All of the entries for the segments of 
a spanned record are grouped into the same section. 


Format of Records in an Alternate Index 


The index component of an alternate index is the same as the index of any 

key-sequenced data set. The data component, too, is the same in form: data 

records, which can be spanned, are stored in control intervals, and control . 
intervals are grouped into control areas. <a 


A data record in an alternate index contains: 
e Header information 


e A key field that contains the alternate key of the base cluster over which 
the alternate index is defined 


e One or more pointers to data records in the base cluster that contain the 
alternate key in the alternate-index record’s key field 


In an alternate index defined with unique keys, data records are fixed in 
length—they contain only one pointer to a base record. In an alternate index 
defined with nonunique keys, data records are variable in length—they can 
contain more than one pointer to base records. 


A pointer to a record in an entry-sequenced base cluster is an RBA pointer. 
It gives the location of the base record by RBA. A pointer to a record in a 
key-sequenced base cluster is a prime-key pointer. That is, it identifies the 
base record by its prime key. VSAM uses the prime-key pointer to go to the 
index of the key-sequenced base cluster to find the base record’s location. 
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The format of a data record in an alternate index is: 


Bytes and 

Offset Bit Pattern Field Name Description 

Header 

0 (0) ] AIXFG Flags that indicate what kind of pointer (s) 
the record contains: 

alae ci 0 RBA pointer(s). 
eiatien 1 Prime-key pointer(s). 
XXXX XXX. Reserved. 

1 (4) 1 AIXPL Length of a pointer. An RBA pointer is four 
bytes long. A prime-key pointer is as long as 
the prime key of the key-sequenced base 
cluster. 

2 (2) 2 AIXPC Number of pointers in the record. 

4 (4) 1 AIXKL Length of the key field in the record. The 
length is the same as the length of the 
alternate key field in base records. (That is, 
the key field in an alternate-index record is 
not compressed.) 

Key Field 

5 (5) VL AIXKY The key field of the record. It contains the 
alternate key of the base record(s) governed 
by the record. 

Pointer(s) 

VL VL AIXPT A pointer to a base record. This field is 


repeated for each base record that contains 
the alternate key in AIXKY. 
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Control Block Interrelationships 


Figure 47 and 48 show the VSAM control blocks built when a key-sequenced 
data set is opened. 





The role of the BIB and CMB in virtual-storage management is described in 
““Virtual-Storage Management” in “‘Diagnostic Aids.”’ 
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Note: The data control block structure is shown in Figure 52. The index control block structure is shown in 
Figure 54. 


Figure 47. VSAM Control Block Structure for a Key-Sequenced Data Set (VSAM User) j 
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Note: The data controt block structure is shown in Figure 52. The index control block structure is shown in 
Figure 54. 


Figure 48. VSAM Control Block Structure for a Key-Sequenced Data Set (ISAM User) 
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Figure 49 shows how a VSAM cluster (QURDATA) is shared between two 

subtasks (User#1 and User#2). When the cluster is opened by User#1, VSAM 

control blocks are built to describe the cluster to VSAM routines. When the | 
cluster is opened by User#2, an AMBL is built to link User#2’s ACB to the J 
cluster’s VSAM control blocks. When either subtask closes the cluster, the | 
subtask’s AMBL is deleted. When the last subtask that is sharing the cluster 

closes it, the VSAM control blocks that describe the cluster to the VSAM 

routines are deleted. 
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Note: The data control block structure is shown in Figure 52. The index control block structure is shown in 
Figure 54. 


Figure 49. VSAM Data Set Control Blocks Before and After Data Set Sharing 
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Figure 50 shows the VSAM control blocks built when a key-sequenced data set (KSDS1) is opened for 
access through a path (PATH1). The path alternate index (AIX1) and a second alternate index (AIX2) 
are members of the upgrade set for KSDS1. 
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Note: The base data control block structure is shown in Figure 52. The alternate-index data control block 
structure is shown in Figure 53. The index control block structure is shown in Figure 54. 


Figure 50. VSAM Control Block Structure for a Key-Sequenced Data Set Accessed through a Path 
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Figure 51 shows the sharing of VSAM control blocks when the key-sequenced data set (KSDS1) shown in 
Figure 50 is opened for access through a path (PATH2) with the second alternate index (AIX2). AMBLs 
are built to link User #2’s ACB to AIX2 and KSDS1. When either user closes his path, the associated 


AMBLs are deleted. 
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Note: The base data control block structure is shown in Figure 52. The alternate-index data control block 


structure is shown in Figure 53. The index control block structure is shown in Figure 54. The 
BIB-UPT-RPL-ACB-upgrade AMBL structure (not shown) is the same as in Figure 50. 


Figure 51. Shared VSAM Control Block Strucutre for a Key-Sequenced Data Set Accessed through Two Paths 
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Figure 52 shows the control blocks that describe a cluster’s data component 
set to VSAM Record-Management routines. 
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Note: The AMBL Control block structure is shown in Figures 49, 50, and §1. The index control block 
structure is shown in Figure 54. 


Figure 52. Data AMB Control Block Structure 
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Figure 53 shows the control blocks that describe an alternate index’s data 
component to VSAM Record-Management routines. 
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Note: The base data control block structure is shown in Figure 52. The index control block structure is shown 
in Figure 54. 


Figure 53. Alternate-Index Data AMB Control Block Structure 
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Figure 54 shows the control blocks that describe a key-sequenced cluster’s 
index component to VSAM Record-Management routines. 
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Note: The AMBL control block structure is shown in Figures 49, 50, and 51. The data control block structure 
is shown in Figure 52. 


Figure 54. Index AMB Control Block Structure 
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Figure 55 shows the VSAM control blocks built for processing with shared 
resources. These control blocks describe the VSAM resource pool. With 
global shared resources (GSR), they are in global storage. With local shared 
resources (LSR), all of them except the IOSBs, SRBs, and PFLs are in the 
user’s address space. For accessibility to the IOSBs, SRBs, and PFLs in case 
of a failure in the address space that contains the local resource pool, the 
ASCB and a chain of VGTTs give their location. 
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Figure 55. Shared Resources Control Block Structure 
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Figure 56 shows the AMB control block structure for processing with shared 
resources. It differs from the structure for processing without shared 
resources, which is shown in Figures 52, 53, and 54. ) 
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Figure 56. AMB Control Block Structure with Shared Resources 


304 OS/VS2 Virtual Storage Access Method (VSAM) Logic 
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Control Block Subpool Assignment 


Control Block Formats 


Subpool 230 in the high end of the user’s private address space contains the 
DEBs, to be consistent with OS/VS I/O Support and Checkpoint/Restart. 
Subpool 245 in the system queue area (SQA, in global storage) contains the 
IOSBs and SRBs because I/O Supervisor, running in any user’s private 
address space, needs them in a place where it can always address them. 
Subpool 252 in the low end of the private area contains the I/O control 
blocks that must be protected from user alteration (including alteration by 
Record Management). The AMBXN is not in 252 (which has storage 
protection key of 0) because it contains fields from the AMB and the IOMB 
that Record Management needs to update. The AMBXN is in subpool 250, 
along with other unprotected control blocks. 


All control blocks for a catalog are kept in global storage, in either Subpools 
231 and 241 in the common service area (CSA) or Subpool 245 in SQA. 


““Virtual-Storage Management” in “‘Diagnostic Aids” indicates the subpools 
in which storage for particular control blocks is indicated. 


This section discusses VSAM control blocks and (except for those adequately 
covered in OS/VS2 Data Areas) gives their format. 


OS/VS2 VSAM Cross Reference (microfiche) has a “Symbol Where Used 
Report” that lists alphabetically all the symbols used in VSAM modules, in 
particular the labels of the control blocks discussed here. With each symbol is 
listed all the modules that use it, along with a code that tells how it is used: 

D defined 

R read (that is, referenced without alteration) 

W written (that is, altered) 

C compared 


ABP—Actual Block Processor (I/O-Management Communication Vector Table) 


The ABP is a communication vector table that contains entry points for I/O 
Management modules located in the nucleus. It is link-edited in the nucleus as 
IDA121CV, along with the modules. 


The ABP is created by NIP and pointed to by the system CVT (CVTIOBP). 
Actual Block Processor (ABP)—Description and Format 


Bytes and 

Offset Bit Pattern Field Name Description 

0 (0) 1 ABPID Control block identifier, X*C1’ 

1 (1) 1 ABPLEN Length of the ABP 

2 (2) 2 ABPBRI14 Unconditional branch, register 14 

4 (4) 4 ABPSIOD Address of the Supervisor-State I/O Driver 
(IGC121) 

8 (8) 4 ABPABP Address of the Actual Block Processor 
routine (IDA121A2) 

12 (C) 4 ABPNE Address of the Normal End Appendage 
(IDA121A3) 

16 (10) 4 ABPAE Adddress of the Abnormal End Appendage 
(IDA121A4) 
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ACB—Access Method Control Block 


The VSAM ACB describes a VSAM cluster. It is built by the user’s program 
with the ACB or GENCB macro. Before the cluster is opened, the ACB can 
be modified by the user’s DD statements and by the MODCB macro. After 
the cluster is opened, the ACB is pointed to by the RPL (RPLDACB) that 
describes the user’s record processing request. 


Access Method Control Block (ACB)—Description and Format 


Offset 
0 (0) 
1 (1) 


2 (2) 
4 (4) 


8 (8) 


12 (C) 


13 (D) 


14 (E) 


15 (F) 
16 (10) 
18 (12) 
20 (14) 


Bytes and 
Bit Pattern 


| 
| 


& N NO — 
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Field Name 
ACBID 
ACBSTYP 


ACBLENG 


ACBAMBL 
ACBIXLST 
ACBJIWA 
ACBIBCT 


ACBINRTN 


ACBMACRF 
ACBMACRI 
ACBKEY 


ACBADR 
ACBADD 


ACBCNV 
ACBBLK 
ACBSEQ 
ACBDIR 
ACBIN 
ACBOUT 
ACBUBF 


ACBMACR2 


ACBSKP 
ACBLOGON 
ACBRST 
ACBDSN 


ACBAIX 


ACBBSTNO 


ACBSTRNO 
ACBBUFND 
ACBBUFNI 
ACBBUFPL 


Description 
Control block identifier, X‘ AO’ 
Subtype: 


X*10’ = VSAM 
X‘20’ = VTAM 


Length of the ACB 


Address of the AMBL 
Address of the index list 


Address of the VSAM Interface routine 
(IDA019R1) 


MACRF flags: 
MACRF flag byte 1: 


The record is identified by a 
key—keyed processing 

The record is identified by a RBA 
(relative byte address) —addressed 
processing 

Control interval processing 


Sequential processing 

Direct processing 

Input (GET, READ) processing 
Output (PUT, WRITE) processing 
User-supplied buffer space 


MACRF flag byte 2: 


Skip sequential processing 

VTAM LOGON indicator 

Set data set to empty state 

Basic subtask shared control-block 
connection on common DSNAMEs 

Object to be processed is the alternate index 
of the path specified in the given DDNAME 
Reserved 


Number of concurrent strings for 
alternate-index path 


Number of RPL strings 

Number of buffers requested for data 
Number of buffers requested for index 
Address of the buffer header (BUFC) 


J 





Access Method Control Block (ACB)—Description and Format 


Bytes and 
Offset Bit Pattern 
20 (14) 1 
Pa oe 
ey ae 
se Altes 
atl 
21 (15) | 
22 (16) 2 
24 (18) 1 
| rere 
25 (19) | 
. XXXX 
26 (1A) 2 
XX.. 
lige 
Te 
..XX XXXX 
ron Pere 
XXXX .XXX 
28 (1C) 4 
32 (20) 4 
36 (24) 4 
Before OPEN 
40 (28) 8 
After OPEN 
40 (28) 2 
42 (2A) 1 
43 (2B) 1 
44 (2C) 1 
45 (2D) 3 
Not Changed by OPEN 
48 (30) 1 


Field Name 


ACBMACR3 


ACBLSR 
ACBGSR 
ACBICI 
ACBDFR 
ACBSIS 
ACBNCFX 


ACBMACR4 
ACBJBUF 

ACBRECFM 
ACBRECAF 
ACBCCTYP 


ACBASA 
ACBOPT 


ACBCROPS 
ACBCRNCK 


ACBCRNRE 


ACBDSORG 


ACBMSGAR 
ACBPASSW 


ACBEXLST 
ACBUEL 


ACBDDNM 


ACBTIOT 
ACBINFL 
ACBAMETH 
ACBERFL 
ACBDEB 


ACBOFLGS 


ACBEOV 
ACBOPEN 
ACBDSERR 


ACBEXFG 
ACBIOSFG 


Description 
MACRF flag byte 3: 


Local shared resource 

Global shared resources 

Improved control-interval access 
Write operations are to be deferred 
Sequential insert strategy 

Control blocks are fixed in real storage 
Reserved 


Reserved 

Number of buffers requested for journal 
Record format: 

JES format 

Control character: 


Reserved 
Control character type 


Non-user options: 


Byte 1: 

Checkpoint/restart options: 

Restart hasn’t checked for modification since 
last checkpoint 

Data added since last checkpoint hasn’t been 
erased by restart, and no reposition to last 
checkpoint takes place 

Reserved 


Byte 2: 
Match with DCBDSORG 
Reserved 


Message area 
Address of the user-supplied password 


Address of the user exit list 


DD name 


Offset to the TIOT 
Indicator flags 
Access method type 
Error flags 

Address of the DEB 


Open/Close flags: 


EOV concatenation 

The ACB is open 

No further requests are possible against 
the ACB 

An ACB Exit routine exists 

The Open or Close routine is in control 
Reserved 
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Access Method Control Block (ACB)—Description and Format 





Bytes and 
Offset Bit Pattern Field Name Description ) 
49 (31) 1 ACBERFLG Error flags 
Note: See ‘‘Open and Close Return Codes’”’ 
in ““Diagnostic Aids’’ for details on the 
ACBERFLG error flags. 
50 (32) 2 ACBINFLG Indicator flags: 
meee ACBJEPS JEPS processing 
a aoe ACBIJRQE RQE being held by JAM 
red ee ACBCAT The ACB describes a VSAM catalog 
bacilie ACBSCRA Catalog recovery area is built 
in system storage 
es ee ACBUCRA Catalog recovery area is built in user's 
storage 
al. ACBSDS A VSAM data set is being opened as a system 
data set 
Gaia Reserved 
51 (33) 1 Reserved 
52 (34) 4 ACBUJFCB Address of the user JFCB 
56 (38) 4 ACBBUFSP Amount of space available for the buffers 
60 (3C) 2 ACBBLKSZ Length of the physical DASD record 
ACBMSGLEN Message length 
62 (3E) 2 ACBLRECL Length of the user’s record 
64 (40) ACBUAPTR Address of the user’s work area 
68 (44) ACBCBMWA Address of the work area for control block 
manipulation ) | 
72 (48) 4 ACBAPID Address of application ID 
AMB—Access Method Block 


The AMB describes a VSAM data set or index and points to control blocks 
needed to process data set and index records, such as the BUFC, the PLH, 
the catalog’s ACB, and the AMDSB. An AMB is built for a cluster’s data set 
and, if the cluster is key-sequenced, an AMB is built for the index. Each 
AMB associated with the cluster is pointed to by the AMBL (AMBLDTA 
points to the data AMB; AMBLIX points to the index AMB). When a data 
set’s or index’s record is being processed by VSAM record management, 
register 3 (RAMB) points to the data set’s or index’s AMB. 


Access Method Block (AMB)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 1 AMBID Control block identifier, X‘40’ 
1 (1) 1 AMBRSC Resource TS byte 
2 (2) Z AMBLEN Length of the AMB 
4 (4) 4 AMBLINK Address of the next AMB in the AMB chain 
8 (8) 4 AMBBUFC Address of the BUFC associated with the 
AMB 
12 (C) 4 AMBPH Address of the PLH associated with the AMB 
16 (10) 4 AMBCACB 
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ACB of the catalog that contains the object’s 
catalog record) 





Address of the VSAM catalog’s ACB (the ) 


Access Method Block (AMB)—Description and Format 


Offset 
20 (14) 
24 (18) 


25 (19) 


26 (1A) 
26 (1A) 
27(1B) 


28 (1C) 


32 (20) 
35 (23) 


38 (26) 
40 (28) 
42 (2A) 


43 (2B) 


44 (2C) 
45 (2D) 
48 (30) 


Bytes and 
Bit Pattern 


4 


Field Name 


AMBDSB 
AMBEOVR 


AMBFLG1 


AMBCREAT 
AMBTYPE 


AMBMCAT 


AMBUCAT 
AMBSPEED 


AMBUBF 


AMBJRN 


AMBINBUF 


AMBDSORG 


AMBDORGA 


AMBIOBAD 
AMBIOMB 


AMBCDSN 
AMBDDSN 


AMBTIOT 
AMBINFL 


AMBCAT 
AMBSCRA 
AMBUCRA 
AMBUPX 


AMBAMETH 
AMBVSAM 


AMBIFLGS 
AMBDEBAD 
AMBOFLGS 


AMBOPEN 
AMBEXFG 
AMBBUSY 


Description 
Address of the AMDSB 


End-of-Volume request type (See AMBXN 
control block: AMBXEOVR field) 


Indicator flags: 


The object is being created 

The AMB describes a data set 

The AMB describes the index of a 
key-sequenced data set 

The AMB describes the master 

catalog 

The AMB describes a user catalog 

Speed option: Control intervals are not 
preformatted before the user’s data records 
are written (only applies when the data 

set is created.) 

The user’s EXLST contains a buffer handling 
exit routine’s address 

The user's EXLST contains a journaling exit 
routine’s address 

The data set is shared—a direct buffer 
request has been issued 


Data set organization indicators: 


Reserved 


VSAM access method 
Reserved 


Address of the IOMB 
Address of the IOMB 


Data set name of the catalog 


Data set name of the object associated with 
the AMB 


Reserved 
Address of the TIOT 
Indicator flags: 


The AMB describes a catalog 

Catalog recovery area is is in system storage 
Catalog recovery area is in user’s storage 
An upgrade table (UPT) exists 

Reserved 


VSAM access method indicator 


VSAM 
Reserved 


Error flags 
Address of the DEB 
Open status flags: 


The AMB is open 

User exit routines are active 
Busy bit 

Reserved 
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Access Method Block (AMB)—Description and Format 


Offset 
49 (31) 


50 (32) 
52 (34) 
56 (38) 


60 (3C) 
64 (40) 
68 (44) 
72 (48) 
76 (4C) 
80 (50) 
84 (54) 
84 (54) 


85 (55) 
86 (56) 
88 (58) 
92(5C) 


96 (60) 

100 (64) 
108 (6C) 
110 (6E) 
112 (70) 
114 (72) 
116 (74) 
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Bytes and 
Bit Pattern 


1 


- &£ ££ fF SF Fk FE F 


—, 


Field Name 


AMBFLG2 
AMBPUG 


AMBRPT 
AMBEDB 
AMBEOVPT 


AMBWKA 
AMBIWA 
AMBIOBA 
AMBPIXP 
AMBPAMBL 
AMBUPLH 
AMBCSWD1 
AMBAFLG 


AMBLSR 
AMBGSR 
AMBICI 
AMBDFR 
AMBSIS 
AMBCFX 


AMBRDCNT 
AMBBM2SH 
AMBCPA 


AMBWSHD 
AMBEXEX 
AMBSZRD 
AMBSZWR 
AMBSZFW 
AMBSZCP 
AMBVIOT 


Description 
Flag byte 2: 


The data set described by this AMB is an 
alternate index in an upgrade set 
Reserved 


Address of the EDB 


Address of the AMBXN for an 
End-of-Volume request 


Address of the AMB work area 
Address of the DIWA 

Address of the IOB 

Address of the index’s AMB 
Address of the primary AMBL 
Address of upgrade placeholder 


Flag byte: 


Local shared resources 

Global shared resources 

Improved control-interval access 
Defer write operations 

Sequential insert strategy 

Control blocks fixed in real storage 
Reserved 


Reserved 
Reserved 
Reserved 


With shared resources: address of the 
WSHD);; without shared resources: address of 
the first CPA in the chain 


Address of working storage header 

Name of user’s exception exit routine 

Size of the channel program for read 

Size of the channel program for write 

Size of the channel program for format write 
Size of the CPA base 

Address of the valid-IOMB table 


C 


AMBL—Access Method Block List 


The AMBL describes a VSAM cluster and points to the cluster’s data set and 
index AMBs. When the cluster is opened, an AMBL is built to describe the 
cluster. If the cluster’s data set (and index) is shared with other users, AMBs 
already exist for the data set (and index). The existing AMB’s addresses are 
put into the AMBL. If the cluster is not shared, AMBs are built to describe 
the cluster’s data set and, if the cluster is key-sequenced, to describe the data 
set’s index. The AMBL is pointed to by the cluster’s ACB (ACBAMBL). 


Access Method Block List (AMBL)—Description and Format 


Offset 
0 (0) 


4 (4) 


8 (8) 


12 (C) 


13 (D) 
14(D) 
16 (10) 
16 (10) 
16 (10) 
20 (14) 


23 (17) 


24 (18) 


28(1C) 


28(1C) 


29(1D) 


Bytes and 


Bit Pattern 


4 


oo XK XXXX 


WwW KR © oO WN 


Field Name 
AMBLPCHN 


AMBLSCHN 


AMBLACB 


AMBLEFLG 


AMBLWAIT 
AMBLESET 


AMBLCOMP 


AMBLDDNM 
AMBLIDF 
AMBLCACB 
AMBLDCI 


AMBLQ 


AMBLDDC 
AMBLGSR 
AMBLLSR 
AMBLFSTP 


AMBLUBF 
AMBLKSDS 
AMBLESDS 
AMBLDFR 
AMBLXPT 
AMBLVC 


AMBLVRT 


AMBLENO 


Description 


Address of the primary AMBL in the AMBL 
chain 


Address of the secondary AMBL in the 
AMBL chain 


Address of the ACB associated with the 
AMBL 


End of Volume flags: 


End of volume is waiting 

End of Volume encountered an error and 
restored control blocks to their original 
condition 

Reserved 


End of Volume lock 

Reserved 

The ACB’s DDNAME field 
Cluster identifier 

Address of the ACB of the catalog 


Control-interval number of the catalog data 
record 


Qualifier: 


DD connect only 

Cluster opened for global shared resources 
Cluster opened for local shared resources 
Cluster opened for fast path (improved 
control-interval access) 

Cluster opened for user buffering 

Cluster opened as a key-sequenced data set 
Cluster opened as an entry-sequenced data 
set 

Cluster opened for deferred writes 


In a base AMBL, address of the path AMBL; 
in a path AMBL, address of the base AMBL 


Identifies the entry in the valid-AMBL table 
that idnetifies this AMBL: 


Number of the valid-AMBL table in the 
chain of valid-AMBL tables 


Offset within the valid-AMBL table 
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Access Method Block List (AMBL)—Description and Format 


Offset 
30(1E) 


31(1F) 
32 (20) 
33 (21) 


34 (22) 
35 (23) 


36 (24) 


37 (25) 
38 (26) 
40 (28) 
41 (29) 
42 (2A) 


52 (34) 
56 (38) 
60 (3C) 
64 (40) 


Bytes and 
Bit Pattern 


- + hb SF 
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Field Name 


AMBLTYPE 


AMBLPATH 
AMBLUPGR 
AMBLAIX 
AMBLBASE 
AMBLFIX 


AMBLID 
AMBLSHAR 


AMBLPRIM 
AMBLCATO 
AMBLWRIT 


AMBLLEN 
AMBLFLGI1 
AMBLFULL 


AMBLCINV 


AMBLUPD 


AMBLVVIC 


AMBLSCRA 


AMBLUCRA 


AMBLCAT 


AMBLDUMY 


AMBLFLG2 
AMBLSTAG 


AMBLNST 
AMBLNUM 


AMBLNIDS 
AMBLMIDS 


AMBLDTA 
AMBLIX 
AMBLBIB 
AMBLCMB 


Description 
Type of control block structure opened: 


Path 

Upgrade set 

Alternate index 

Base cluster 

Control blocks are fixed in real storage 
Reserved 


Reserved 
Control block identifier, X*50’ 
Sharing indicators: 


Identifies the primary AMBL 

The catalog is open 

The user intends to write or update records 
in the data set 

Reserved 


Length of the AMBL 
Flags: 


The user-supplied master password was 
verified 

The user-supplied control-interval 
password was verified 

The user-supplied update password was 
verified 

The AMBL is for the mass storage volume 
inventory (MSVI) data set 

The AMBL is for a catalog recovery area in 
system storage 

The AMBL is for a catalog recovery area in 
user’s storage 


The AMBLACB field points to a catalog’s 
ACB 

A DD DUMMY statement was specified 
The combination of these bits indicates the 
type of data set: 


001 Catalog 
101 MSVI 
011 SCRA 
Flags: 


Cluster is staged 
Reserved 


Number of strings 

Number of AMB pointers in the AMBL 
Reserved 

Number of identifiers 


Five 2-byte fields, each containing a VSAM 
module’s identifier 


Address of the cluster’s data set AMB 
Address of the cluster’s index AMB 
Address of the base information block 


Address of the cluster management block 


J 


AMBXN—Access Method Block Extension 


The AMB and the IOMB are kept in a protected subpool with key 0. They 
cannot be changed by the user or by Record Management. Record 
Management needs to store information in the AMB and the IOMB. Some of 
their fields have been moved to the AMBXN. It contains one set of fields for 
the AMB and one set for each IOMB associated with the AMB. 


Access Method Block Extension (AMBXN)—Description and Format 


Bytes and 
Offset Bit Pattern 
AMB Portion 
0(0) 
0(0) 4 
4(4) 1 
5(5) 1 
X‘80’ 
x‘O1’ 
X'81’ 
X‘02’ 
X‘82’ 
6(6) 2 
8(8) 8 
16(10) 4 
16(10) 2 
18(12) 
20(14) 4 
IOMB Portion 
0(0) 1 
1(1) 1 
Lesa tyes 
-XXX XXXX 
2(2) 2 
4(4) 14 
4(4) 2 
6(6) 2 
8(8) 4 
12(C) 4 
16(10) 4 
20(14) 4 
20(14) 1 
| Pearrre 
-XXX XXXX 
..XX XXXX 
21(15) 3 


Field Name 


AMBXEOV 
AMBXEVPT 


AMBXRSC 
AMBXEOVR 


AMXRMWA 
AMBXCSWD 


AMBXRDCT 
AMBXBM2S 


IOMXLOCK 
IOMXFLGS 
IOMXUSE 


IOMXPDET 
IOMXBFLG 


IOMXR13S 
IOMXRPL 


IOMXRECB 
IOMXECB 


IOMXWAIT 
IOMXRSLT 
IOMXPOST 
IOMXIOCC 


IOMXRBPT 


Description 


End-of-Volume Interface fields (IDAEOVIF) 


Address of the key or RBA to be used by End 
of Volume 


Resource TS byte 
End-of-Volume request type: 


Page-space data set 
Mount by key 
Mount by RBA 
Allocate by key 
Allocate by RBA 


Reserved 
Reserved 


Used by Buffer Management for shared 
resources serialization 


Unused 
Number of control intervals read 


Address of the PLH being used for a second 
search of a subpool 


Resource TS byte 
I/O-Management flags: 


Error processing is complete 
Reserved 


Reserved 

Problem-determination fields 

I/O Flags at I/O initiation 
Reserved 

Address of the user’s save area 
Address of the first RPL in a chain 
Reserved 

Record Management I/O ECB 
I/O ECB: 


I/O wait bit 

I/O completion result 
I/O post bit 

I/O completion code 


Pointer to RB (request block) or result 
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AMDSB—Access Method Data Set Statistics Block 


The AMDSB contains statistical information about record processing in the 
data set. It also contains some of the data set’s attributes and specifications. 
The AMDSSB is built, using the data set or index catalog record’s AMDSB set 
of fields, when the cluster is opened. The data or index AMB (AMBDSB) 
points to its associated AMDSB. 


Access Method Data Set Statistics Block (AMDSB)—Description and Format 


Bytes and 
Offset Bit Pattern 
0 (0) 1 
1 (1) 1 
| Parner 
Ong ets 
ee 
Bead (ee 
Pee ee 
re 
ae) I 
ee 1 
2 (2) 2 
4 (4) 2 
6 (6) 2 
8 (8) 
10 (A) 1 
11 (B) 1 
12 (C) 
14 (E) 2 
16 (10) 4 
20 (14) 4 
24 (18) 4 
28 (1C) 4 
32 (20) 4 
36 (24) 4 
40 (28) 56 
40(28) 1 
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Field Name 
AMDSBID 
AMDATTR 
AMDDST 


AMDWCK 
AMDSDT 


AMDREPL 
AMDORDER 


AMDRANGE 
ANDRRDS 
AMDSPAN 


AMDLEN 


AMDNEST 
AMDAXRKP 


AMDRKP 
AMDKEYLN 
AMDPCTCA 


AMDPCTCI 


AMDCIPCA 
AMDFSCA 


AMDFSCI 
AMDCINV 
AMDLRECL 
AMDHLRBA 


AMDNSLOT 
AMDSSRBA 


AMDMAXRR 
AMDPARDB 
AMDSTAT 
AMDATTR3 
AMDUNQ 


AMDFAULT 


AMDBIND 


Description 
Control block identifier, X‘60’ 
Attributes of the data set: 


Key-sequenced data set 
Entry-sequenced data set 

Check each record when it is written 
Sequence set is stored with the data and 
replicated 

All index records are replicated 

Use the volumes in the same order as in the 
volume list 

The data set is divided into key ranges 
Relative record data set 

The data set contains spanned records 


Length of the AMDSB 


Number of index entries in the index section 
Relative key position of the alternate key 


Relative key position 
Key length 


Percentage of free control intervals in the 
control area 


Percentage of free bytes in the control 
interval 


Number of control intervals in a control area 


Number of free control intervals in a control 
area 


Number of free bytes in a control interval 
Control interval size 
Maximum record size 


Relative byte address (RBA) of the high-level 
index record 
Number of record slots per control interval 


Relative byte address (RBA) of the first 
sequence-set record 
Maximum valid relative record number 


Address of the first ARDB 
Data set statistics: 
Attributes of the data set: 


The data set has: 

0 Unique keys 

1 Nonunique keys 

The data set is staged: 

0 At open time, if required 
1 Bycylinder fault 

The data set is: 


Access Method Data Set Statistics Block (AMDSB)—Description and Format 


Offset 


41(29) 


48 (30) 
56 (38) 
58 (3A) 
60 (3C) 


64 (40) 
68 (44) 
72 (48) 
76 (4C) 
80 (50) 
84 (54) 
88 (58) 
92 (5C) 


Bytes and 
Bit Pattern 


& N NH OO 


& &f& Lf fF FL Fk LH fF 


Field Name 


AMDWAIT 


AMDLM 


AMDSTSP 
AMDNIL 
AMDNEXT 
AMDNLR 


AMDDELR 
AMDIREC 
AMDUPR 
AMDRETR 
AMDASPA 
AMDNCIS 
AMDNCAS 
AMDEXCP 


Description 


0 Not bound 

1 Staged and bound 

After destaging is begun, control is returned 
to the program that is closing the data set: 

0 Immediately 

1 After destaging is finished 

0 Load mode, or data set is not loaded 

1 Data set is loaded 

Reserved 


Reserved 


OS/VS system timestamp 
Number of index levels 
Number of extents in the data set 


Number of user-supplied records in the data 
set 


Number of deleted records 

Number of inserted records 

Number of updated records 

Number of retrieved records 

Number of bytes of free space in the data set 
Number of times a control interval was split 
Number of times a control area was split 


Number of times EXCP was issued by VSAM 
I/O routines 
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ARDB—Address Range Definition Block 


The ARDB contains information about space allocated to and space actually 
used by a data set. The block is built by the VSAM Open routine from 
information in the data set’s catalog record. The number of ARDBs depends 
on whether the data set is divided into key ranges (one ARDB per range, or 
one for a data set without ranges) and whether the sequence set of the index 
is placed adjacent to data. 


The ARDB is updated by Record-Management routines as additional space is 
used. The first ARDB in an ARDB chain is pointed to by the AMDSB 


Address Range Definition Block (ARDB)—Description and Format 


(AMDPARDB). 
Bytes and 
Offset Bit Pattern 
0 (0) 1 
1 (1) 1 
Eneerer 
oi ieee 
ory ieee 
Pore ere 
Piles 
vag0 84 XX 
2 (2) 2 
4 (4) 4 
8 (8) 4 
12 (C) 4 
16 (10) 4 
20 (14) 6 
26 (1A) 2 
28 (1C) 1 
| anes 
ei ee 
XX XXXX 
29 (1D) VL 
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Field Name 
ARDID 
ARDTYPE 


ARDKR 
ARDHLI 


ARDSS 


ARDUOVFL 
ARDEOD 


ARDUSED 


ARDLEN 


ARDNPTR 


ARDHKRBA 


ARDHRBA 


ARDERBA 


ARDVOLSR 


ARDRELNO 


ARDPRF 


ARDPRSS 
ARDPRFMT 


ARDKEYS 


Description 
Control block identifier, X‘61’ 


Identifies the type of space defined by the 
ARDB: 


One key range of a key-range data set 

The total index of a key-sequenced data set, 
or 

The non-sequence set levels of a 
key-sequenced data set’s index, when the 
sequence set is stored with the data 

The sequence set of a key-sequenced data set, 
when the sequence set is stored with the data 
Overflow may be used for this key range 


The key range containing the highest 
data RBA in the data set 

The ARDHRBA field’s initial value 
has changed 

Reserved 


Length of the ARDB 


Address of the next ARDB in the ARDB 
chain 


The RBA of the data set control interval 
containing the key range’s high-key value 


The RBA of the next free-space control 
interval at the end of the data set 


The RBA of the highest control interval 
allocated to the key range 


The serial number of the volume containing 
the highest RBA allocated to the key range 


The sequence number of the Data Space 

Group set of fields that describes the data 
space containing the key range—the Data 
Space Group set of fields is in the volume 
catalog record identified by ARDVOLSR 


Preformat flags: 


The sequence set is stored with the data 
The key range’s extents haven’t been 
preformatted 

Reserved 


The key range’s low and high key 
values—the length of this field equals twice 
the key length 


2 


BIB—Base Information Block 


The BIB contains information for Virtual-Storage Management to control 
allocation of storage for a particular base cluster in a job step. It is further 
described in ‘‘Virtual-Storage Management” in “Diagnostic Aids.” 


The BIB is pointed to by the AMBL (AMBLBIB). 
Base Information Block (BIB)—Description and Format 


Offset 
0 (0) 
0 (0) 
1 (1) 


2 (2) 
4 (4) 
5 (5) 
8 (8) 
12 (C) 
16 (10) 
20 (14) 


24 (18) 
28 (1C) 
32 (20) 
36 (24) 


40 (28) 


44 (2C) 
48 (30) 
52 (34) 
56 (38) 


60 (3C) 
60 (3C) 
64 (40) 
68 (44) 
72 (48) 


76 (4C) 


84 (54) 


92 (5C) 


Bytes and 
Bit Pattern 


> fh bh b p>» fh fh Ph WD — 


pA fbf Ft 


Field Name 
BIBHDR 
BIBID 
BIBFLG1 


BIBVIRT 
BIBREST 
BIBCKPT 


BIBLEN 
BIBFLG2 


BIBUPT 
BIBVMT 
BIBDACB 
BIBAMBL 


BIBSPHPT 
BIBPRSPH 
BIBHEBPT 
BIBHEBFQ 


BIBVCRT 


BIBWSHD 
BIBCSL 
BIBPSAB 
BIBVGTT 


BIBRTNS 
BIBINTRF 
BIBCEAPP 
BIBASYRT 
BIBSIOAP 


BIBJOBNM 


BIBSTPNM 


BIBDDNM 


Description 

Header: 

Control block identifier, X‘10’ 
Flag byte 1: 


At least one mass-storage UCB is allocated 
Restart in progress for sphere 

Checkpoint in progress for sphere 
Reserved 


Length of the BIB 

Reserved 

Reserved 

Address of the upgrade table 
Address of the volume mount table 
Address of an inner (‘““dummy”) ACB 


Address of the primary AMBL in the AMBL 
chain : 


Address of the sphere block header 
Address of the protected sphere block 
Address of the header element block 


Address of the first free header element in 
the header element block 


Address of the VSAM checkpoint/restart 
table 


Address of the working storage header 
Address of the first core save list in the chain 
Address of the protected sphere AMBL block 


Address of the VSAM global termination 
table for the control blocks stored in global 
storage for a base cluster and its related 
clusters 


Addresses of Record-Management routines: 
VSAM interface (IDA019R1) 

Channel end appendage 

Asynchronous Routine 

Start-I/O appendage 

Name of the job that issued OPEN for the 
base cluster 


Name of the job step that issued OPEN for 
the cluster 


Name of the DD statement specified for 
OPEN 
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Base Information Block (BIB)—Description and Format 


Offset 


100 (64) 


Bytes and 
Bit Patten 


4 


BLPRM—Resource Pool Parameter List 


BLPRM is created by the BLDVRP and DLVRP macros. It is used by Record 
Management for dynamic string addition and by data set management 
(O/C/EOV and Checkpoint/Restart) for internal processing. BLPRM is 
mapped by IDABLPRM and pointed to by the parameter list whose address is 


in register 1 when SVC 19 is issued. 


Field Name 
BIBASCB 


Description 


Address of the address space control block 
for the address space that issued OPEN 


Resource Pool Parameter List (BLP RM)—Description and Format 


Offset 
0 (0) 
1 (1) 
2 (2) 
4 (4) 


8 (8) 
9 (9) 
10 (A) 


11 (B) 


12 (C) 
13 (D) 
16 (10) 
16 (10) 


Bytes and 
Bit Patterns 


1 
1 
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Field Name 
BLPACBID 
BLPACBST 


BLPBUFLP 


BLPUACB 


BLPIOPLH 


BLPKEYLN 
BLPSTRNO 
BLPFLAG1 


BLPFDBDC 
BLPFBLD 
BLPFDEL 
BLPFLSR 
BLPFGSR 
BLPFIOBF 
BLPFBFRF 
BLPFSTAD 


BLPFLAG2 


BLPFPART 
BLPFUPGR 
BLPFPATH 
BLPFPRIM 
BLPFDATA 
BLPFINDX 
BLPFIOSR 
BLPFRSTR 


BLPOCODE 
BLPOACB 
BLPCORE 
BLPGFLG 


BLPGREQ 
BLPGPG 


Description 

ACB ID—X‘A0’ 
ACB subtype—X‘11’ 
Reserved 


Address of the buffer list used by BLDVRP 
(described below) 


Address of the user ACB (used for dynamic 
string addition) 


Address of the I/O Support PLH (used for 
CLOSE) 


Key length 
String number requests 
Flag byte 1: 


Shared resources 
BLDVRP request 
DLVRP request 
LSR option 

GSR option 

Fix IOBs 

Fix buffers 

Add String 


Flag byte 2 (used for I/O support internal 
processing): 


Partial build request 
Upgrade set Open 
Path (AIX) Open 
Primary Open 

Data AMB 

Index AMB 

I/O support request 
Restart request 


Special use field 

Address of ACB 

Record management GETCORE request 
Flag byte: 


GETCORE request 
GETCORE page boundary request 
Reserved 


Resource Pool Parameter List (BLPRM)—Description and Format 


Offset 
17 (11) 
20 (14) 
21 (15) 
24 (18) 
24 (18) 
27 (1B) 


28 (1C) 
48 (30) 
49 (31) 
51 (33) 


Bytes and 
Bit Pattern 


3 


—_—= Ww Fk WW —_ 


20 


2 
1 


Field Name 


BLPGSZ 
BLPGSP 
BLPGAD 
BLPIOACB 


BLPDSORG 


BLPOFLGS 


BLPERFLG 


Description 

GETCORE length 
GETCORE subpool 
GETCORE return address 
Address of I/O support ACB 
Reserved 


X‘08’ (required for BLDVRP, DLVRP, and 
string addition) 


Reserved 
X‘02’ 
Reserved 


X‘00’ 


The buffer request list (pointed to by BLPBUFLP) is repeated once for each buffer 


pool. The format is: 


0 (0) 
4 (4) 


5 (5) 
6 (6) 


BSPH—Buffer Subpool Header 


4 


BLPBUFSZ 
BLPBRLFG 
BLPBFLST 


BLPBFLCT 


Buffer size 
Buffer list flags: 


Last buffer request 
Reserved 


Reserved 


Buffer count 


The BSPH is built for processing with shared resources. It defines a buffer 
pool in the VSAM resource pool. The first BSPH for the resource pool is 
pointed to by the VSRT (VSRTBUFH). Each BSPH is pointed to by an AMB 
(AMBBUFC) that uses the buffer pool defined by the BSPH. 


Buffer Subpool Header (BSPH)—Description and Format 


Offset 
0 (0) 
1 (1) 


2 (2) 
4 (4) 
8 (8) 


12 (C) 
14 (E) 
16 (10) 


20 (14) 


24 (18) 


Bytes and 
Bit Pattern 


Field Name 
BSPHID 
BSPHFLG1 
BSPHIOBF 


BSPHBFRF 
BSPHLEN 
BSPHNM 
BSPHNBSP 


BSPHBFNO 
BSPHERCT 
BSPHBUFC 


BSPHMDBT 


BSPHBSZ 


Description 
Control block identifier, X‘72’ 
Flag byte 1: 


I/O-related control blocks are fixed in real 
storage 
I/O buffers are fixed in real storage 


Length of the BSPH 
Visual name: ‘BSPH’ 


Address of the next BSPH for the resource 
pool 


Number of buffers in the buffer pool 
Count of write errors 


Address of the first BUFC for the buffers in 
the pool 


Modification bits—they indicate IDs of 
transactions that have modified the buffer 
(RPL TRANSID operand) 


Length of each buffer in the pool 
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Buffer Subpool Header (BSPH)—Description and Format 


Offset 
28 (1C) 


28 (1C) 


29 (1D) 
30 (IE) 
32 (20) 


36 (24) 


40 (28) 


44 (2C) 


48 (30) 


52 (34) 


56 (38) 
60 (3C) 


Bytes and 
Bit Pattern 


4 
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Field Name 
BSPHCSRC 


BSPHFLG2 


BSPHAPRT 
BSPHPCUC 


BSPHPSUC 
BSPHCPLH 


BSPHRDS 


BSPHFND 


BSPHUIW 


BSPHNUIW 


BSPHUTOP 


BSPHUBTM 
BSPHI1ST 


Description 

Compare/Swap resource—used to serialize 
the use chain: 

Flag byte 2: 


Arithmetic protect bit 
The use chain is being changed 
Reserved 


Reserved 
Number of PLHs searching the use chain 


Address of the PLH that is modifying the use 
chain 


Number of I/O operations to bring data into 
the buffer pool 


Number of requests for retrieval that could 
be satisfied without an I/O operation 


Number of user-initiated writes from the 
buffer pool 


Number of non-user-initiated writes (writes 
that VSAM was forced to do because no 
buffers were available) 


Address of the top of the use chain 
Address of the bottom of the use chain 


Address of the first BSPH for the resource 
pool 


BUFC—Buffer Control Block 


The BUFC consists of a buffer header that describes the buffer pool and a 
buffer control entry that describes each buffer requested by the user and each 
buffer required for preformat processing. The header describes the structure 
of the buffer pool. Each buffer control entry contains function codes, status 
indicators, and RBAs to describe the buffer. The buffer control entry also 
contains the address of its associated placeholder (PLH), the data buffer, the 
associated channel program (pointed to by the CPA), and the next BUFC in 
the chain. 


Index and data have separate blocks of BUFCs. At the end of each block are 
BUFCs used for preformat processing—they are pointed to by a field in the 
header. 


The BUFC is the interface between I/O Management and Buffer 
Management (IDA019R2 and its procedures). The BUFC is pointed to by the 
PLH (PLHBUFC points to the data BUFC; PLHIBUFC points to the index 
BUFC). 


Both the buffer header and the buffer control entry are created by Open and 
released by Close. The AMB points to the buffer header. The DIWA points 
to the insert buffer control entry, and each placeholder points to a chain of 
one or more data buffer control entries and one index buffer control entry. 


Buffer Control Block (BUFC)—Description and Format 


Bytes and 

Offset Bit Pattern Field Name Description 

Buffer Header 

0 (0) 1 BUFDRID Buffer-header identifier, X‘70’ 

1(1) 1 BUFDRNO Number of buffer control entries in this 
buffer pool, excluding preformat buffer 
control entries 

2 (2) 2 BUFDRLEN Length of the buffer header and all buffer 
control entries associated with this buffer 
pool 

4 (4) 4 BUFDRPFB Pointer to the first BUFC in a pool of BUFCs 
that are reserved for preformatting data 
control areas or index tracks 

8 (8) 1 BUFDRPFN Number of preformat BUFCs 

9 (9) 1 BUFDRCIX Number of index buffers in an index buffer 
pool that are not assigned to a placeholder 
and are not reserved for the highest level 
index record 

BUFDRMAX Maximum number of buffers that can be 
assigned to a placeholder that is in sequential 
mode 

10 (A) 1 BUFDRTSB Test-and-set byte for the buffer header—this 


byte is set to X°FF’ when a buffer is being 
taken from the buffer pool and assigned to a 
placeholder; set to X‘00’ in all other cases 
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Buffer Contro] Block (BUFC)—Description and Format 


Bytes and 
Offset Bit Pattern 
11 (B) 1 
| ae 
le 
XX XXXX 
12(C) 4 
16(10) 4 
Buffer Control Entry 
0 (0) 1 
1 (1) 1 
1... 
a ee 
os eee 
Se: 
ee lee 
ee Ie 
res 1 
2 (2) 1 
i Ree 
Ace 
oes lee 
Pee eee 
oe 
ei ie 
aie chee 1 
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Field Name 


BUFDRFLG 
BUFDRREL 


BUFDRAVL 


BUFDBUFC 


BUFCAVL 
BUFCUCNT 


BUFFLGI1 


BUFCUPG 
BUFCSEG 


BUFCINS 
BUFCER! 
BUFCER2 


BUFCVAL 
BUFCEXC 


BUFCEPT 
BUFCIOFL 
BUFCMW 


BUFCFMT 
BUFCRRD 
BUFCREAL 
BUFCWC 


BUFCXEDB 


BUFCPFCP 


BUFCFIX 


Description 
Buffer status flags: 


Buffer-released flag, which is set when a 
placeholder returns a buffer to the buffer 
pool 

Buffer is available, which is set when there 
are data buffers in the pool that are not 
reserved for inserts and are not assigned to 
placeholders 

Reserved 


Address of the first BUFC 


Reserved 


Test-and-set byte for the buffer 
Use count 


BUFC status flags: 


This BUFC is associated with an upgrade set 
The buffer contains a segment of a spanned 
record 

Identifies this buffer as an insert buffer—this 
buffer can be assigned to a placeholder for 
data only for the duration of a single request 
Error generated by input processing 

Error generated by output processing 

Input RBA is valid 

The control interval represented by this 
BUFC is in exclusive control—this field is 
meaningful only when the input RBA is valid 
I/O-complete flag 


I/O status flags: 


Control interval must be written at the 
indicated output RBA (BUFCORBA)—note 
that output processing is done before input 
processing for the same BUFC 

This BUFC is associated with a format-write 
channel program 

The control interval indicated by 
BUFCDDDD must be read 

BUFCBAD is a real address 

The channel program associated with this 
BUFC includes write-validity-checking 
CCWs 

The RBA that was to be read or written was 
in an extent of the data set that was 
unavailable (for example, not mounted) 


Preformatted channel-program segment is 
complete 
Buffer is fixed in real storage 


CLW—CLOSE Work Area 


Buffer Control Block (BUFC)—Description and Format 


Offset 
3 (3) 


4 (4) 


8 (8) 


12 (C) 


16 (10) 
20 (14) 


24 (18) 
28 (1C) 


28 (1C) 
32 (20) 
36 (24) 


37 (25) 
40 (28) 


44 (2C) 
48 (30) 
52 (34) 


56 (38) 
60 (3C) 


Bytes and 
Bit Pattern 


1 


4 


b 


Field Name 


BUFCFLG2 
BUFCXDDR 


BUFCNLAS 
BUFCBSYR 


BUFCBSYW 


BUFCPLH 


BUFCAMB 


BUFCDDDD 


BUFCORBA 


BUFCCPA 


BUFCBAD 


BUFCNXT1 
BUFCINV 


BUFCWLEN 
BUFCDSPC 
BUFCIDXL 


BUFCNXT2 
BUFXIRBA 


BUFXORBA 
BUFCHAIN 
BUFCMDBT 


BUFCUCUP 
BUFCUCDN 


Description 
Flags: 


Suppress dynamic device reconfiguration on 
errors 

Indicates last BUFC 

For processing with shared resources, a read 
operation is in progress—the bit is on during 
the operation 

For processing with shared resources, a write 
operation is in progress—the bit is on during 
the operation 

Reserved 


Address of the placeholder associated with 
this BUFC 

Address of the access method block 
associated with this BUFC 


RBA for input processing (valid only if bit in 
FLG1 is set) 


RBA for output processing (valid only if 
IOFL indicates that a control interval must 
be written). 


Channel program area address 


Address to or from which control interval is 
to be written or read 


Next BUFC for which I/O can be requested 


Invoker’s field for OS/VS Auxiliary Storage 
Manager 


BUFC data length 
Address of data-set page-control table 


For processing without shared resources, the 
level of the index record in the buffer—used 
in the selection of the buffer to be replaced 


Address of the next logical buffer 


RBA of the record in the buffer or, fora 
spanned record, of the record’s first segment 


Same as BUFXIRBA, but used for output 
Address of the next BUFC in the pool 


For shared resources, modification 
bits—they identify IDs of transactions that 
have modified the buffer (RPL TRANSID 
operand) 


Address of the next BUFC up the use chain 


Address of the next BUFC down the use 
chain 


The CLW contains information used for communication among the CLOSE 
and temporary CLOSE modules. It is built by IDAQ200T (CLOSE) and 
IDA0231T (CLOSE, TYPE=T), mapped by IDACLWRK, and pointed to by 
register 4 during VSAM CLOSE processing. 
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CLOSE Work Area (CLW)—Description and Format 


Offset 
0 (0) 

8 (8) 
12 (C) 
16 (10) 
28 (1C) 


CMB—Cluster Management Block 


Bytes and 
Bit Patterns 


8 
4 
4 


Field Name 
CLWID 
CLWCOMWK 
CLWAMBPT 
CLWSFI 
CLWFLAGS 


CLWBNOFL 
CLWCNOUP 
CLWNWRIT 
CLWPATH 
CLWSPHCL 
CLWDUMMY 
CLWOUTPT 
CLWPARCL 


CLWPRMCL 
CLWSECCL 
CLWGMAIN 
CLWTERM 


Description 

Work area ID—IDACLWRK 
Address of common work area 
Address of current AMB 
Subfunction information area 


Flag bytes: 


No buffer flush 

No catalog update 

No write buffer 

Path processing 

Close entire sphere 

Dummy data set 

Base data set opened for output 
Partial close 


Primary close 

Secondary close 

Module work area built 
Terminating error in IDA0200B 
Reserved 


The CMB contains the addresses of header elements in the header element 
block that describe storage obtained for the control blocks of a 
key-sequenced or entry-sequenced data set. 


The CMB is pointed to by the AMBL (AMBLCMB). It is further described 
in “Virtual-Storage Management” in “Diagnostic Aids.” 


Cluster Management Block (CMB)—Description and Format 


Offset 
0 (0) 
1(1) 
2 (2) 
4 (4) 


5 (5) 


6 (6) 
8 (8) 


8 (8) 

12 (C) 
16 (10) 
20 (14) 
24 (18) 


Bytes and 
Bit Pattern 


1 


= » 


-_ br bh AS A 
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Field Name 
CMBID 


CMBLEN 
CMBFLGS 
CMBOUT 


CMBNST 


CMBCNT 
CMBPTRS 


CMBUSRPT 
CMBPRPTR 
CMBSTPTR 
CMBUSPTR 
CMBFSTPT 


Description 

Control block identifier, X‘11’ 
Reserved 

Length of the CMB 

Flags: 


The control block structure allows output 
requests 
Reserved 


Number of strings set up in the control block 


structure 


Number of addresses that follow: 


Addresses of header elements in the header 
element block. 


User block header 

Protected user block header 
String block header 
Upgrade string block header 
Fixed string block header 


Cluster Management Block (CMB)—Description and Format 


Offset 

28 (1C) 
32 (20) 
36 (24) 
40 (28) 
44 (2C) 
48 (30) 
52 (34) 
56 (38) 
60 (3C) 


CPA—Channel Program Area 


Bytes and 
Bit Pattern 


aN 


a bh bf bh HL HF SH A 


Field Name 
CMBUFSPT 
CMBBFRPT 
CMBUBFPT 
CMBDEBPT 
CMBEDBPT 
CMBPSTPT 
CMBPUSPT 
CMBFXDPT 


Description 

Fixed upgrade string block header 

Buffer block header 

Upgrade buffer block header 

DEB (data extent block) block header 
EDB (extent definition block) block header 
Protected string block header 

Protected upgrade string block header 
Fixed block header 


Reserved 


The CPA contains addresses to CCW chains that perform specialized I/O 
processing. The CPA also contains information needed to convert the 
addresses of virtual storage data areas to real main storage addresses for the 
channel. Each BUFC has a CPA associated with it, pointed to by the 


BUFCCPA. 


Note: See I/O-Management module listings for channel program building and 
execution details. The formats of four channel programs follow this 
description of the CPA. 


Channel Program Area (CPA)—Description and Format 


Offset 
0 (0) 
1 (1) 
2 (2) 
4 (4) 


8 (8) 


12 (C) 


16 (10) 


20 (14) 


24 (18) 


28 (1C) 


32 (20) 


36 (24) 


36 (24) 
37 (25) 
37 (25) 


Bytes and 
Bit Pattern 


1 
l 


Field Name 
CPAID 


CPALEN 
CPAWREAL 


CPAWCPS 


CPAWCPE 


CPAWCKS 


CPAWCKE 


CPARREAL 


CPARCPS 


CPARCPE 


CPAWPHAD 


CPAWSEEK 
CPAWBB 


Description 

Control block identifier, X‘°71’ 
Reserved 

Length of the CPA 


Real address of the previous write channel 
program segment 


Real address of the first CCW in the write 
channel program segment 


Real address of the last CCW in the write 
channel program segment 


Real address of the first CCW in the write 
check channel program segment 


Real address of the last CCW in the write 
check channel program segment 


Real address of the previous read program 
channel segment 


Real address of the first CCW in the read 
channel program segment 


Real address of the last CCW in the read 
channel program segment 


The physical address for records to be 
written, in the form MBBCCHHR: 


Reserved (M value) 
Seek address: 


BB value 
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Channel Program Area (CPA)—Description and Format 


Bytes and 
Offset Bit Patten Field Name Description 
39 (27) 4 CPAWCHR Cylinder and head address (CCHH value) 
43 (2B) 1 CPAWPHR Reserved (record number R) 
44 (2C) 4 CPAWSID Address of the search argument list for write 
channel program segments 
48 (30) 4 CPAFWCNT Address of the count fields list for the format 
write channel program segment 
52 (34) 8 CPARPHAD The physical address for records to be read, 
in the form MBBCCHHR: 
52 (34) 1 Reserved (M value) 
53 (35) 6 CPARSEEK Seek address: 
53 (35) 2 CPARBB BB value 
55 (37) 4 CPARSID Cylinder and head address (CCHH value) 
(Read search-ID argument) 
59 (3B) 1 Reserved (record number R) 
60 (3C) 4 CPAIDAL Address of the real page list (indirect 
data-address list) 
64 (40) 4 CPAVPL Address of the virtual page list 
68 (44) 4 CPAWORK1 Work area 
72 (48) 4 CPAWORK2 Work area 
76 (4C) 4 CPABLKSZ The physical blocksize value calculated by 
the I/O Manager: Convert routine 
80 (50) 2 CPABCINV Number of physical blocks per control 
interval 
82 (52) 1 CPASSECT Set sector argument 
83 (53) 1 CPASTAT1 Flags: 
| eee CPAVPLV The virtual page list (VPL) is valid 
XXX XXXX Reserved 
84 (54) 2 CPAFLAGS Flags: 
84 (54) Byte 1 CPAFLAGI1 
| eae CPAWV The write channel program segment is valid 
me CPAWCV The write check channel program segment 
is valid 
el [eae CPARV The read channel program segment is valid 
wel. CPAWRPS The write channel program segment 
(preceeded by a set sector CCW) is 
valid 
eae eee CPARRPS The read channel program segment 
(preceeded by a set sector (CCW) is 
valid 
ape ee CPACHNED Chaining of the channel program segments 
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is complete 
Reserved 


Channel Programs 


Read Channel Program 


Channel Program Area (CPA)—Description and Format 


Bytes and 
Bit Pattern 


Offset 
85 (55) 


86 (56) 
87 (57) 
88 (58) 
92 (SC) 


Byte 2 


Field Name 


CPAFLAG2 
CPAWREPL 


CPARREPL 
CPAXLRA 

CPAPFENT 
CPATKOFL 


CPARSECT 
CPAWSECT 
CPANXT1 
CPACPCHN 


Description 


The write channel program segment 

is used to write replicated index 

records 

The read channel program segment is used to 
read replicated index records 

There has been a LRA instruction error 

The pagefix appendage has been called 


Track overflow 
Reserved 


Set sector argument—read 
Set sector argument—write 
Next CPA in chain from AMB 


Next CPA for a particular request (from 
IOMB) 


Four channel programs (read, format write, update write, and write check) 
are used for I/O operations. 


The read channel program is used to retrieve data from direct-access storage. 
Read Channel Program—Description and Format 


CCW 
Number 


Rl 
R2 
R3 
R4 
R52 


Ra 


Command Code 

Hex Description 

1B Seek head 

231 Set sector 

31 Search ID eq. 
08 TIC 

063 Read data 

864 M-T read data 
035 No op 


Flags 

Address Hex Description Count 

CPARSEEK 40 CC 6 

CPARSECT 60 CC,SLI 1 

CPARSID 60 CC,SLI 5 

R3 

IDAL 40 CC CPABLKSZ 

IDAL 49 CC CPABLKSZ 
| 20 SLI 2 


1 Unless there is RPS (rotational position sensing), R2 is a no op. 


2 R5 is repeated for each physical record per control interval that is retrieved. 


3R5 uses a read-data command for the first physical record. 


4R5 uses a multiple-track read-data command for subsequent physical records. 


5 Rn can be changed to a TIC (transfer in channel) command to chain to another read 
channel program. 
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Format Write Channel Program 


Update Write Channel Program 


The format write channel program is used to preformat or write data on a 
whole track (as in loading a data set with the SPEED option). 


Format Write Channel Program—Description and Format 


CCW Command Code Flags 

Number Hex Description Address Hex Description Count 

Fwil 1B Seek head CPAWSEEK 40 CC 6 

FW2 231 Set sector CPAWSECT 60 CC, SLI 1 

FW3 31 Search ID eq. CPAWSID 40 CC 5 

FWw4 08 TIC FW3 

FWS2 D Write C,K,&D CPAFWCNT 80 CC 8 

FW@ D WriteC,K,&D IDAL 44 CC,IDAL CPABLKSZ 
FWn 033 No op 20 ~=SLI 2 


1 Unless there is RPS (rotational position sensing), FW2 is a no op. 


2FWS5 and FW6 are repeated (write count, key, and data) for each physical record on a 
track. 


3 FWn can be changed to a TIC (transfer in channel) command to chain to another format 
write channel program or to a write check channel program. 


The update write channel program is used to write data on a part of a track 
(as in insertion). 


Update Write Channel Program—Description and Format 


CCW Command Code Flags 

Number Hex Description Address Hex Description Count 

Uwl 1B Seek head CPAWSEEK 40 CC 6 

Uw2! = =23 Set sector CPAWSECT 60 CC, SLI | 

UW32 = 31 Search ID eq. CPAWSID 40 CC 5 

UW2 08 TIC UW3 

UWS2 = 05 Write data IDAL 44 CC,IDAL CPABLKSZ 
UWn 033 No op 20 ~=SLI 2 


1 Unless there is RPS (rotational position sensing), UW2 is a no op. 


2UW3, UW4, and UW5S are repeated for each physical record indicated in the CPA. The 
command code for subsequent UW3s is B1, multiple-track search ID equal. 


3UWn can be changed to a TIC (transfer in channel) command to chain to another update 
write channel program or to a write check channel program. 


328 OS/VS2 Virtual Storage Access Method (VSAM) Logic 


Write Check Channel Program 


The write check channel program is used to retrieve data to compare it with 
the data that was previously written. 


Write Check Channel Program—Description and Format 


CCW Command Code Flags 

Number Hex Description Address Hex Description Count 

WCl 1B Seek head CPAWSEEK 40 CC 6 

WC2 231 — Set sector CPAWSECT 60 CC,SLI 1 

WC3 31 Search ID eq. CPAFWCTN2 40 CC 

CPAWSID3 

WC4 08 TIC WC3 

WC5 064 Read data IDAL 50 CC, Skip CPABLKSZ 
865 M-T read data IDAL 50 CC, Skip CPABLKSZ 

WCn 036 No op 20 ~=SLI 2 


1 Unless there is RPS (rotational position sensing), WC2 is a no op. 
2CPAFWCNT is used to check a format write. 

3 CPAWSID is used to check an update write. 

4WC5 uses a read-data command for the first physical record. 

5 WCS5 uses a multiple-track read-data command for subsequent physical records. 


6WCn can be changed to a TIC (transfer in channel) command to chain to another write 
check channel program. 
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CSL—Core Save List 


The CSL contains up to 32 entries that describe virtual-storage areas acquired 
by GETMAIN in Open. It enables Open to free these areas if it detects an 
error that prevents them from being freed in normal Open termination. The 
CSL is used by the Open error-cleanup routine as well as by the recovery 


routine. 


The CSL is pointed to by the BIB. Additional CSLs are chained as required. 


Core Save List (CSL)—Description and Format 


Offset 
0 (0) 
0 (0) 
1 (1) 
4 (4) 
12 (C) 


16 (10) 
18 (12) 
20 (14) 


CSL Entry 


0 (0) 
0 (0) 
0 (0) 
1 (1) 
4 (4) 
8 (8) 


9 (9) 


DIWA—Data Insert Work Area 


Bytes and 
Bit Pattern 


4 


> © WwW = 


Field Name 
CSLRO 
CSLSUBPL 
CSLLENTH 
CSLID 
CSLNXPTR 


CSLACTEN 


CSLNTRYS 


CSLENTRY 
CSLFREMN 
CSLPOOLN 
CSLCORLN 
CSLCORPT 
CSLFLAGS 


CSLKEY5 
CSLKEY7 


CSLJSTCB 


CSLANCPT 


Description 

Used to load register 0 for FREEMAIN 
Subpool number of the CSL 

Length of the CSL 

Identifier: ‘bIDACSLB’ 


Address of the next CSL (zero for the last 
CSL in the chain) 


Number of active entries 
Reserved 


Entries for virtual-storage areas: 


An entry for a virtual-storage area: 
Information for FREEMAIN 

Subpool number of the virtual-storage area 
Length of the virtual-storage area 

Address of the virtual-storage area 

Flags: 


The storage is in key 5 

The storage is in key 7 

The storage is in key 0 or the key of the 
problem program 

The storage is owned by the job-step TCB 
Reserved 


Address of the CMB location that contains 
the address of the header element in the HEB 
for the virtual-storage area, or zero 


The DIWA is a work area used by the control area and control interval 
splitting modules. The DIWA is pointed to by the data AMB (AMBIWA). 


Data Insert Work Area (DIWA)—Description and Format 


Offset 
0 (0) 
1(1) 


2 (2) 
4 (4) 


Bytes and 
Bit Pattern 


1 
1 


2 
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Field Name 
DIWID 
DIWATV 


DIWLEN 
DIWFLG!1 


Description 
Control block identifier, X°41’ 


Test-and-set (TS) assembler instruction is 
issued against this field to obtain exclusive 
use of the DIWA 


Length of a DIWA in bytes 
Flag byte 1: 


Data Insert Work Area (DIWA)—Description and Format 


Offset 


5 (5) 


6 (6) 
8 (8) 


12 (C) 

16 (10) 
20 (14) 
24 (18) 
28 (1C) 
28 (1C) 
32 (20) 
36 (24) 


40 (28) 
44 (2C) 


Bytes and 
Bit Pattern 


ha bh hh HR BF 


Field Name 


DIWCAS 
DIWCISPL 


DIWPFERR 
DIWEOKR 


DIWGSPC 
DIWSHIFT 
DISNOT1 
DIWIST 
DIWFLG2 
DIWFSPF 


DIWLRBA 


DIWHRBA 


DIWPLH 


DIWBUFC 


DIWSPLTP 


DIWSAVE 


DIWSAVE1 


DIWSAVE2 


DIWSAVE3 


DIWSAVE4 
DIWSAVES 


Description 


Control-area split is in progress 
Control-interval split has been 

performed 

I/O error occurred during preformating 
Key of a record to be inserted in a key-range 
data set is greater than the highest possible 
key in the current key range—this 
end-of-key-range condition causes a 
control-interval split 

Spanned record needs a new control area 
There is a shift in the insert point 

The buffer had intermediate or last segment 
of a spanned record 

The buffer had first or intermediate segment 
of a spanned record 


Flag byte 2: 


Preformatting is needed in an 
entry-sequenced data set 
Reserved 


Reserved 


Address of the first control interval in a 
control area that is being split 


Address of the last control interval in a 
control area that is being split 


Address of the PLH which is currently 
associated with the DIWA 


Address of the BUFC that controls the insert 
work buffer 


Address of the RDF associated with the first 
record to be moved to a new control interval 
as a result of a control-interval split 


Register save area: 
Register 1 
Register 2 
Register 3 
Register 4 
Register 5 
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DSL—DEB Save List 





The DSL contains up to 16 entries that describe DEBs that have been 
successfully chained and added to the DEB table. It enables Open to free the 
DEBs if an error prevents them from being freed normally. The DSL is used 
only by the Open error-cleanup routine, not by the recovery routine. 


The DSL is pointed to by OPWA (called the ACB work area). Additional 
DSLs are chained as required. 


DEB Save List (DSL)—Description and Format 


Bytes and 
Offset Bit Pattern 


0 (0) 

1 (1) 3 

4(4) g 

12 (C) 4 

16 (10) 2 

18 (12) 2 

20 (14) 4x 16 

20 (14) 1 
edna 1 
XXXX XXX 

21 (15) 3 


EDB—Extent Definition Block 


The EDB describes all extents of the space allocated to the cluster’s data set. 
The EDB is built by the VSAM Open routine from information in the data 
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set’s catalog record. 


Field Name 
DSLSUBPL 
DSLLENTH 
DSLID 
DSLNXPTR 


DSLACTEN 


DSLENTRY 
DSLFLG 
DSLFDDEB 


DSLDEBAD 


Description 

Subpool number of the DSL 
Length of the DSL 
Identifier: ‘6IDADSLb’ 


Address of the next DSL (zero for the last 
DSL in the chain) 


Number of active entries 
Reserved 

Entries for DEBs: 

Flags: 


The DEB is a dummy DEB 
Reserved 


Address of the DEB 


The EDB header contains the length of the EDB and the number of EDB 
entries that follow the header. Each EDB entry describes an extent, and 
contains the address of the associated LPMB. The EDB header is pointed to 
by the AMB (AMBEDB). 


Extent Definition Block (EDB)—Description and Format 


Bytes and 
Offset Bit Pattern 


EDB Header 
0 (0) 
1 (1) 


2 (2) 
4 (4) 
EDB Entry 
0 (0) 
2 (2) 


3 (3) 


kh N 


Field Name 


EDBID 
EDBNO 


EDBLEN 
EDBLPMBC 


EDBFLG1 


EDBLKR 
EDBTOFLW 
EDBPSDS 


EDBM 


Description 


Control block identifier, X*90’ 


Number of EDB entries—one EDB per 
extent 


Length of an EDB entry in bytes 
Address of first LPMB 


Reserved 
Flags 


For a catalog, low-key range 

For page-space data set, track overflow used 
Page-space data set 

Reserved 


Extent number—specifies the relative 
location of an extent entry in a DEB 


J 


ESL—Enqueue Save List 


Extent Definition Block (EDB)—Description and Format 


Offset 
4 (4) 
8 (8) 


12 (C) 
16 (10) 
20 (14) 


Bytes and 
Bit Pattern 


4 
4 


Field Name 


EDBLPMBA 
EDBSTTRK 


EDBLORBA 
EDBHIRBA 
EDBTKBAL 


Description 
Address of LPMB 


Relative track address of the extent 
associated with this EDB 


RBA of the start of the extent 
RBA of the end of the extent 


For track-overflow processing, the number of 
bytes left on a track after the last I/O 
operation 


The ESL contains up to 16 entries that describe ENQ requests that have been 
issued by Open, Close, or End of Volume for data set sharing. It enables 

Open to dequeue the indicated resources if an error prevents them from being 
dequeued normally. The ESL is used only by the Open error-cleanup routine, 
not by the recovery routine. 


The ESL is pointed to by OPWA (called the ACB work area). Additional 
ESLs are chained as required 


Enqueue Save List (ESL)—Description and Format 


Offset 
0 (0) 
1 (1) 
4 (4) 
12 (C) 


16 (10) 
18 (12) 
20 (14) 
20 (14) 


21 (15) 


21 (15) 
24 (18) 


28 (1C) 


Bytes and 
Bit Pattern 


1 


bh oO WwW 


9x 16 


Field Name 
ESLSUBPL 
ESLLENTH 
ESLID 
ESLNXPTR 


ESLACTEN 


ESLENTRY 
ESLENQOP 


ESLRNAME 


ESLCINBR 
ESLACBAD 


ESLIO 


Description 
Subpool number of the ESL 


Length of the ESL 
Identifier: ‘bIDAESLb’ 


Address of the next ESL (zero for the last 
ESL in the chain) 


Number of active entires 
Reserved 
Entries for resources enqueued: 


The ENQ option that was used for this 
resource: 


0 Exclusive use 
1 Shared use 


ENQ resource name (minor) that identifies 
this resource: 


Control-interval number for the resource 


Address of the ACB of the catalog for the 
resource 


Indicator of the purpose of the ENQ: 


I input 
O output 
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EXLST—Exit List 


The EXLST contains the addresses of exit routines supplied by the user. It is 
created by the user with the EXLST or GENCB macro. The EXLST is j 
pointed to by the ACB (ACBEXLST). 


Exit List (EXLST)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 1 EXLID Control block identifier, X‘°81’ 
1 (1) 1 EXLSTYP Subtype identifier: 
X‘10’ = VSAM 
X‘20’ = VTAM 
2 (2) 2 EXLLEN Length of the control block 
4 (4) 1 Reserved 
5 (5) 1 EXLEODF Entry description 
6 (6) 4 EXLEODP Address of the EODAD exit routine 
10 (A) 1 EXLSYNF Entry description 
11 (B) 4 EXLSYNP Address of the SYNAD exit routine 
15 (F) 1 EXLLERF Entry description 
16 (10) 4 EXLLERP Address of the LERAD exit routine 
20 (14) 10 Reserved 
30 (1E) 1 EXLJRNF Entry description 
31 (1F) 4 EXLJRNP Address of the JRNAD exit routine 
35 (23) 10 Reserved 
HEB—Header Element Block J 


The HEB is used by VSAM Virtual-Storage Management to allocate and free 
unprotected storage blocks. It contains 16 header elements, each of which 
describes a storage block. It is further described in “‘Virtual-Storage 
Management” in “Diagnostic Aids.” 


The HEB is pointed to by the BIB (BIBHEBPT). The first free header 
element is pointed to by BIBHEBFQ. 


Header Element Block (HEB)—Description and Format 


Bytes and 

Offset Bit Pattern Field Name Description 

HEB Block Definition 

0 (0) 1 HEBID Control block identifier, X*13’ 

1 (1) 1 Reserved 

2 (2) 2 HEBLEN Length of the HEB (including header 
elements) 

4 (4) 4 HEBNHEB Address of the next HEB (or 0) 

8 (8) 2 Reserved 

10 (A) 2 HEBCNT Number of header elements 

12 (C) 20 x 16 HEBHDELS Header elements: 

HEB Header Element Definition 

0 (0) 8 HEBFREMN Information for freeing the storage block . 
described by this header element: Jd 

0 (0) 1 HEBSP Subpool in which the storage block is located 
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Header Element Block (HEB)—Description and Format 


Offset 


1 (1) 
4 (4) 
8 (8) 


9 (9) 


12 (C) 
16 (10) 


ICWA—Index Create Work Area 


Bytes and 
Bit Pattern 


3 
4 


4 


Field Name 


HEBLN 
HEBBLKPT 
HEBFLAGS 


HEBJSTCB 
HEBKEY5 
HEBKEY7 


HEBIOSUP 
HEBRTFLG 


HEBAVSP 


HEBELCHN 
HEBNBYTE 


Description 

Length of the storage block 
Address of the storage block 
Flags: 


The storage is owned by the job step TCB 
The storage is in key 5 

The storage is in key 7 

Storage is obtained in key 0 or in 
problem-program key 

O/C/EOV special request block 
Recovery termination freed storage 
Reserved 


Amount of space available in the storage 
block 


Address of the next header element 


Address of the next available byte 


The ICWA contains information needed when a VSAM index record is being 
built or modified during key-sequenced data set creation. The sequence-set 
ICWA is pointed to by the index AMB (AMBIWA). ICWAs are built by 
Open; there is one for each level of the index. 


Index Create Work Area (ICWA)—Description and Format 


Offset 
0 (0) 
1 (1) 


2 (2) 
4 (4) 
8 (8) 
12 (C) 
16 (10) 
20 (14) 


22 (16) 
24 (18) 
28 (1C) 
32 (20) 
36 (24) 
40 (28) 


Bytes and 
Bit Pattern 


N bh fh Rh SF N 


Field Name 
ICWID 
ICWFLGI1 


ICWWNF 
ICWWAGM 
ICWRBAOK 
ICWVSE 
ICWVNE 
ICWKRDS 
ICWSPLIT 
ICWENDRQ 


ICWLEN 
ICWCHN 
ICWBUFC 
ICWCRBA 
ICWPRBA 
ICWPSEO 


ICWSCNT 
ICWADD 
ICWTBASE 
ICWTPTR 
ICWARDBP 
ICWLN 


Description 
Control block identifier, X‘43’ 
Flag byte: 


Entry won't fit in the index record 

The Open routine did not supply a workarea 
Don’t get RBA on initial 

The section entry is valid 

The previous entry is valid 

The data set is divided into key ranges 

The work area contains a split index record 
The Close routine requires a control interval 
split 


Length of the ICWA 

Address of the next ICWA 
Address of the current index BUFC 
Current index RBA 

Previous index RBA 


Displacement from the beginning of the 
index record to the prior section entry 


Number of entries in the current section 
Address of the current work area 

Base RBA 

Address of the index save position 
Address of the current ARDB 


Index level number 
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Index Create Work Area (ICWA)—Description and Format 


Offset 

42 (2A) 
44 (2C) 
46 (2E) 
48 (30) 
50 (32) 
52 (34) 
54 (36) 
55 (37) 
56 (38) 


57 (39) 


58 (3A) 


59 (38) 


60 (3C) 
VL 
VL 


Bytes and 
Bit Pattern 


2 
2 
2 
2 
4 
2 
1 


1 
1 


(key length) 
(key length) 
(key length) 


IICB—ISAM Interface Control Block 


Field Name 


ICWKEYI1L 
ICWKEY2L 
ICWKEY3L 
ICWNEST 


ICWNOSEG 


ICWCRSEG 
ICWREQ 
ICWPTL 
ICWCER 


ICWCEF 


ICWCEL 


ICWCERP 


ICWKEY1 
ICWKEY2 
ICWKEY3 


Description 

Length of the current key 

Length of the previous key 

Length of the section key 

Number of entries in the index section 
Number of segments in a spanned record 
Number of the segment being processed 
Request type 

Index entry pointer length 


Rear compression count of the current index 
entry 


Current index entry F—number of front-key 
compressed bytes 


Current index entry L—length of the 
compressed key in the entry 


Rear compression count of the previous 
index entry 


Save area for the current key 
Save area for the previous key 


Save area for the section key 


The IICB is used to address the DCB (ISAM) and the ACB and RPL 
(VSAM) control blocks and associated areas needed by the ISAM interface. 
The IICB is pointed to by the DEBWKPTS field in the ISAM DEB to provide 
integrity and by the RPLIICB field in the RPL Extension to provide the 
connection to VSAM control programs. 


ISAM Interface Control Block (IICB)—Description and Format 


Offset 
0 (0) 
1 (1) 
2 (2) 
4 (4) 
8 (8) 
12 (C) 
16(10) 
16 (10) 
18 (12) 
20 (14) 
24 (18) 


Bytes and 
Bit Pattern 


1 


— 


& NO NY fb F&F & SH N 
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Field Name 
IICBID 


IICBLEN 
IIDCBPTR 
IIACBPTR 
IIRPLPTR 
ITW1CBF 
IISAVLRL 
IIMAXLRL 
IIKEYPT 
IIFLAG1 


IIFSCAN 
IIFGET 
IIFPASS 
IIFCLOSE 
IIDATA 


Description 

Control block identifier, X°80’ 
Reserved 

Length of IICB, in bytes 

Address of DCB 

Address of ACB 

Address of RPL 

Address of dummy scan work area 
Length of current record 
Maximum record length 

Address of key (dummy ISAM) save area 
ISAM interface status flags: 


Scan mode 

First GET request 
First pass in load mode 
Close in process 

Data only retrieval 


ISAM Interface Control Block (IICB)—Description and Format 


Bytes and 
Offset Bit Pattern 


25 (19) 3 
28 (1C) 1 
icc 
co 
ee 
Ba en 
dcx 
= 
sa 
ae 1 
29 (1D) 3 
32 (20) 2 
34 (22) 2 
36 (24) 1 
—— 
XXX XXXX 
37 (25) 3 
40 (28) 4 
44 (2C) 1 
45 (2D) 3 
48 (30) 4 
52 (34) 
60 (3C) 72 
60 (3C) 
64 (40) 
68 (44) 4 
72 (48) 60 
132 (84) 36 
132 (84) 4 
132 (84) 1 


Field Name 


IIFTEST 
IISEQCHK 
IIQBFRS 


ITACBL 


IIFLAG2 


MRKP 
MLRECL 
MBLKSI 
MOPTCD 
MRECFM 
MBUFL 
MBUFNO 
MKEYLE 


ITRPLL 


IIKEYSL 
IIBUFL 


IIFLAG3 
MBFALN 


IIMSGL 
IIMSGPTR 
IIBUFNO 


ITTBUFL 


IISVCLST 
IISAMSYN 


IIREGSAV 


ITIREGBC 
ITREGFC 


AUD 
ITAUDHDR 
ITAUDFL1 


AUDACBOP 
AUDACBRO 
AUDDCBEX 
AUDDCBRT 
AUDPRMOD 


Description 


Loop test bit 

Resume load sequence check 
QISAM does not use buffers—no 
FREEMAIN is required 


ACB, EXLST, IICB length for 
GETMAIN/FREEMAIN 


ISAM interface status flags used by Open to 
designate the fields being merged by ISAM 
Interface. ISAM Interface Close uses the 
same mask to restore the DCB to its pre-open 
Status. 


Relative key position 
Logical record length 
Block size 

Option code 

Record format 
Buffer length 

Buffer number 

Key length 


RPL and RPLE: length for 
GETMAIN/FREEMAIN 


Length of key save area, in bytes 


Length of single ISAM Interface buffer (used 
in calculations) 


ISAM interface status flags: 


BFALN merge bit 
Reserved 


Message area length 
Message area pointer 


Number of ISAM Interface buffers built by 
Open 


Total BCB and buffer length for 
GETMAIN/FREEMAIN 


SVC exit for SYNADAF 


ISAM SYNAD name—used when SYNAD is 
specified in the AMP parameter 


Register save area 
Reserved 

Previous save area pointer 
Next Save area pointer 
Remainder of save area 


Audit information 


Audit flags 


OPEN was issued for ACB 

Control was returned from Open 

A DCB exit was taken 

Control was returned from the DCB exit 
A processing module was loaded: 

‘01’ IDAIIPM1 
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ISAM Interface Control Block (IICB)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description ‘ 
‘10°IDAIIPM2 = 
‘11’ IDAIIPM3 
cidade AUDIISYN ISAM-Interface SYNAD routine was loaded 
sate cnee 1 AUDURSYN User SYNAD routine was loaded 
133 (85) 1 IILAUDFL2 Audit flags 
| ener AUDIIFBF IDAIIFBF was loaded 
alas. eees AUDACBCL CLOSE was issued for ACB 
soles isa. AUDACBRC Control was returned from Close 
a eee AUDBFREX A flush-buffer exit was taken to IDAJIPM1 
eee! ee AUDBRFRT Control was returned from IDAIIPM1 
ruled AUDDEBXF The DEB extension was freed 
siaGne XX Reserved 
134 (86) 2 IIGMCNTR Offset from IIAUD to the next available 
entry in the audit-information fields 
136 (88) 32 IIGMAUD Address of virtual-storage areas gotten 
136 (88) 4 AUDIICB Address of this IICB 
140 (8C) 4 AUDCSPLI Subpool number and length 
140 (8C) 1 AUDCSPI Subpool number 
141 (8D) 3 AUDCLI Length 
144 (90) 4 AUDCDEB Address of the DEB 
148 (94) 4 AUDCSPLD Subpool number and length 
148 (94) 1 AUDCSPD Subpool number 
149 (95) 3 AUDCLD Length 
152 (98) 4 AUDCBFRS Address of the area for buffers and RPLs ) 
156 (9C) 4 AUDCSPLB Subpool number and length 
156 (9C) 1 AUDCSPB Subpool number 
157 (9D) 3 AUDCLB Length 
160 (AQ) 4 AUDCMSGA Address of the physical-error message area 
164 (A4) 4 AUDCSPLM Subpool number and length 
164 (A4) 1 -AUDCSPM Subpool number 
165 (A5) 3 AUDCLM Length 


IMWA—Index Insert Work Area 


The IMWA is a control block used in inserting an index entry into the index 
of a key-sequenced data set. The IMWA is created by the Open routine, and 
is pointed to by the ICWA (ICWCHN). 


Index Modification Work Area (IMWA)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 1 IMWID Control Block identifier, X*42’ 
1 (1) 1 IMWFLAGS Control flags: 
| Preece IMWNEWHL Indicates a new high level should be built 
in the index structure 
i eee IMWRIPL Indicates a new entry must be built in an 
index record at the next higher level to 
reflect a new index record created by an ) 
index split 
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Index Modification Work Area (IMWA)—Description and Format 


Offset 


2 (2) 
4 (4) 
8 (8) 
40 (28) 


44 (2C) 
48 (30) 


52 (34) 


56 (38) 


60 (3C) 


64 (40) 


65 (41) 


66 (42) 
67 (43) 
68 (44) 


70 (46) 
72 (48) 
76 (4C) 


Bytes and 
Bit Pattern 


-X XXXX 


2 
4 


2 
4 
(key length) 


Field Name 
IMWBSE 


IMWLEN 
IMWIXSP 
IMWISWKA 
IMWXKEYP 


IMWIKEYP 
IMWXPTR 


IMWIPTR 


IMWLBUFC 


IMWBUFP 
IMWFGAIN 


IMWIEL 


IMWSVIEL 


IMWCIMVN 


IMWNSOFF 


IMWKEY1 


Description 


Indicates the new index entry should be a 
section entry 
Reserved 


Length of IMWA in bytes 
Address of index search parameter list 


Index search parameter list (see IXSPL) 


Address of the next (higher-keyed) index 
entry 


Address of the new index entry’s key 


Value of the index pointer field in the next 
(higher-keyed) index entry 


Value to be inserted in new index entry's 
pointer field 


Address of a data BUFC for a data buffer 
containing the lowest key following a 
control-area split 


Address of the index record being processed 


Front key-compression adjustment to be 
added to IBFLPF field in next (higher-keyed) 
index entry 


Value of IBFLPL field—that is, compressed 
length of new index entry's key 


Save area for IBFLPL value 
Reserved 


Readjustment to number of control intervals 
in old control area following a control area 
split to enable an index record to be built for 
the new control area 


Offset to next section entry in index record 
Reserved 


Highest possible key for a mass 
insertion—that is, last key in a sequence of 
keys to be inserted which is less than an 
existing key; also, save area for current insert 
key under a no-fit condition 
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IOMB—I/O-Management Block 


The IOMB is used by I/O Management to control its processing of a request. 
It contains the addresses of other control blocks, flags used by I/O 
Management, and a 16-word register save area. The addresses of the first 
BUFC and CPA are inserted by I/O Management after it verifies the control 


blocks. 


The IOMB is pointed to by the PLH (PLHIOB). It points to the IOSB, which 
points to the SRB. These three control blocks take the place of the IOB, 
which is used by some other drivers of the I/O Supervisor. 


I/O Management Block (IOMB)—Description and Format 


Offset 
0 (0) 
4 (4) 
8 (8) 
12 (C) 
16 (10) 
20 (14) 
24 (18) 
28 1C) 


32 (20) 


36 (24) 
40 (28) 
40 (28) 


42 (2A) 
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Bytes and 
Bit Pattern 


4 


-& ff fh ff Lf Hh LF 


Field Name 
IOMBID 
IOMBUFC 
IOMCPA 
IOMPLH 
IOMAMB 
IOMIQE 
IOMECBPT 
IOMVSL 


IOMPGAD 


IOMIOSB 
IOMFLAGS 
IOMFL 


IOMAPEND 
IOMNE 
IOMAE 
IOMPURGE 
IOMCBERR 
IOMADERR 


IOMPGFIX 
IOMCSW 


IOMDDR 


IOMSTIND 


IOMAMUSE 
IOMEOVW 
IOMEOVTS 
IOMEOVXC 
IOMLLOCK 
IOMSLOC 
IOMSRBM 


Description 

Control block identifier: ‘IOMB’ 

Address of the first BUFC 

Address of the first CPA 

Address of the PLH 

Address of the AMB 

Address of the IQE (interrupt queue element) 
Address of the ECB 


Address of the VSL (virtual subarea list, 
which is the same as the PFL, page fix list) 


Address of the caller to get control when I/O 
operation is complete (zero for Record 
Management—used for Auxiliary Storage 
Management) 


Address of the IOSB 
Flags: 
Flags reset after I/O completes: 


Byte 1: 

Appendage flags: 

Normal End Appendage completed 
Abnormal End Appendage completed 

A purge is in progress 

A control block wasn't valid 

Virtual addresses in the VPL weren't 
successfully converted to real addresses for 
the IDAL 

Pages are fixed in real storage 

The address of the channel status word is 
incorrect 

Reserved 


Byte 2: 
Dynamic-device reconfiguration 
Reserved 


Status indicators: 


The IOMB is in use 

End of Volume is waiting for an IOMB 
End of Volume has set the IOMLOCK field 
End-of-Volume indicator 

A local lock ts held 

SALLOC is held 

The user is processing with SRB (event) 
dispatching 

Reserved 


3 


J 


I/O Management Block (IOMB)—Description and Format 


Offset 

43 (2B) 
44 (2C) 
45 (2D) 
46 (2E) 


48 (30) 
50 (32) 
52 (34) 
52 (34) 


116 (74) 
120 (78) 


IOMBXN—I/O Management Block Extension 


Bytes and 


Bit Pattern 


1 
1 
1 


64 


4 
4 


See the AMBXN. 


IOSB—I/O-Supervisor Block 


Field Name 


IOMCKEY 
IOMPFERR 
IOMLOCK 
IOMNMOD 


IOMNBUF 
IOMNSEG 
IOMSAVER 


IOMSAVEO 
through 
IOMSAVEF 


IOMNXT1 
IOMUFLD 


Description 

Key of the caller of I/O Management 
Return code from the VS2 PGFIX routine 
End-of-Volume lock 


Number of modules to be fixed in real 
storage 


Number of buffers 
Number of channel program segments 
16-word register save area and work area: 


16 four-byte registers save areas 


Address of the next IOMB 
Address of the IOMB extension (IOMBXN) 


The IOSB is used by the VS2 I/O Supervisor to initiate and terminate an I/O 
operation. It is passed to the I/O Supervisor by VSAM I/O Management 
(IDA121A2—the Actual Block Processor), along with an SRB. 


The IOSB is used to communicate between the I/O Supervisor and the 
requester of I/O, between the I/O Supervisor and an error-recovery 
procedure, between an error-recovery procedure and write-to-operator and 
statistics-update modules, and among the components of the I/O Supervisor. 
It is also used to control successive entries from the I/O Supervisor to an 
error-recovery procedure. 


The format of the IOSB is given in OS/VS2 Data Areas. 


IXSPL—lIndex Search Parameter List 


The IXSPL is used to pass index search parameters to the index search 
routine. It also contains status information about the results of the search. It is 
used as a work area by the SCIB (Search Compressed Index Block) routine 
(IDA019RC). The PLH contains the address of the IXSPL (PLHISPLP) or 
the contents of the IXSPL (PLHIXSPL). 


Index Search Parameter List (IXSPL)—Description and Format 


Offset 
0 (0) 
4 (4) 
8 (8) 
12 (C) 


13 (D) 


Bytes and 
Bit Pattern 


4 
4 
4 


Field Name 
IXSSTRBA 
IXSBUFC 
IXSARG 
IXSTLN 


IXSILN 


Description 

RBA of the index record to search first. 
Address of the index BUFC 

Address of the search argument (a key field) 


Index level number at which the search is to 
terminate 


Index level number at which the search is to 
begin 
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Index Search Parameter List (IXSPL)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description ) 


14 (E) 3 Reserved 
17 (11) 1 IXSBFLG Flags: 


IXSSSRH Used by the Search Compressed Index 

Search routine: 

| rere Search for a section entry only 

Osesceen Search for a normal entry 

a Peeener IXSLELV The entry located by the Index 
Search routine is the last entry 
in the terminating level 
(F =O and L = 0) 

XX XXXX Reserved 

18 (12) 1 IXSEKON Length of the F, L, and pointer fields in each 

index entry 


19 (13) 1 IXSPEC The number of characters in the index entry 
preceding the entry located by the Index 
Search routine that equalled the search 
argument 


20 (14) 4 IXSHEP Address of the index entry located by the 
Index Search routine 


24 (18) 4 IXSSEP Address of the section entry that is greater 
than or equal to the index entry located by 
the Index Search routine 


28 (1C) 4 IXSLEP Address of the lowest-valued entry in the 
section identified by IXSSEP 


KEYWDTAB—Keyword Processing Table a 


KEYWDTAB is a branch tabe that controls the execution of IDA019C1 and 
supports processing for the GENCB, MODCB, SHOWCEB, and TESTCB 
macros. The table is built by and contained within IDA019C1 and is not 
referred to by any other module. The table contains one 14-byte row for each 
keyword processed by a control block macro, and each row is identified by a 
keyword type code (0-255). Each column in the table represents functions for 
the keywords and contains index points for specific keyword functions. Each 
column also contains either offsets and lengths for byte-oriented fields or 
pointers to descriptive information about bit-oriented fields. The index points 
are used to route specific requests through IDA019C1 on the bases of 
keyword, block (ACB, EXLST, NIB (VTAM), and RPL), and function 
(GENCB, MODCB, SHOWCEB, and TESTCB). 
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Offset 
0 (0) 
0 (0) 
0 (0) 
1 (1) 
2 (2) 
3 (3) 
3 (3) 
4 (4) 
5 (5) 
6 (6) 
6 (6) 
7 (7) 
8 (8) 
9 (9) 
10 (A) 
11 (B) 
12 (C) 
13 (D) 


14 (E) 


28 (1C) 


Bytes 
14 

3 

1 


14 


14 


3570 (DF2) 14 


LPMB—Logical-to-Physical Mapping Block 


Description 

The description for the keyword with type code = 0 (KW00) 
The index points for the ACB 

The index point for MODCB of the ACB 

The index point for SHOWCB of the ACB 

The index point for TESTCB of the ACB 

The index points for the EXLST 

The index point for MODCB of the EXLST 

The index point for SHOWCB of the EXLST 

The index point for TESTCB of the EXLST 

The index points for the RPL 

The index point for MODCB of the RPL 

The index point for SHOWCB of the RPL 

The index point for TESTCB of the RPL 

The index points for the NIB (VTAM) 

The index point for SHOWCB of the NIB 

The index point for TESTCB of the NIB 

The offset to a bit definition if this is a bit-level keyword 


The offset of the resultant field in the target field, if this is a byte 
field 


The description for the keyword with type code = 1 (KW01) 


The description for the keyword with type code = 2 (K W072) 


The description for the keyword with type code = 255 (KW255), the 
maximum value 


The LPMB contains information about the direct-access device that contains 
the user’s data set. The LPMB is built by the VSAM Open routines, which 
use information in the data set’s catalog record. Each EDB entry 
(EDBLPMBA) contains the address of an LPMB. 


Logical-to-Physical Mapping Block (LPMB)-——Description and Format 


Offset 
0 (0) 
1 (1) 


Bytes and 
Bit Pattern 


Field Name Description 
LPMBID Control-block identifier, X‘91’ 
LPMBFLGS Flags: 
LPMBRPS The device has the rotational position 
sensing (RPS) feature 
LPMREPL Records are replicated on the track 
LPMSS Sequence set records are stored with the data 
records 
LPMBTOFL Track overflow 
LPMBSSTH The set sector table is included at 
the end of the LPMB 
Reserved 
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Logical-to-Physical Mapping Block (LPMB)—Description and Format 


Bytes and 

Offset Bit Pattern Field Name Description 

2 (2) Z LPMBLEN Length of the LPMB 

4 (4) 4 LPMAUSZ The minimum number of bytes that can be 
allocated to an object. Allocation is always an 
integer multiple of LPMAUSZ. For a data 
set, this field is the control interval size. For 
an index, this field is the device’s track size. 

8 (8) 4 LPMBPTRK Number of bytes per track 

12 (C) 4 LPMBLKSZ Number of bytes per physical record (control 
interval) 

16 (10) Z LPMTRKAU Number of tracks per allocation unit (extent) 

18 (12) LPMTPC Number of tracks per cylinder 

20 (14) 2 LPMBLKTR Number of physical records (control 
intervals) per track 

22 (16) Reserved 

24 (18) 4 LPMBEXT Reserved for address of LPMB extension 

28 (1C) VL LPMBSST Set sector table—it is built by Open for use in 


OPW—OPEN Work Area 


deriving the sector number from the record 
number 


OPW is the common work area used by VSAM OPEN routines. It is built by 
IDA0192A, mapped by IDAOPWRK, and pointed to by register 4 during 


VSAM processing. 
OPEN Work Area (OPW)— Description and Format 
Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 1 OPWSUBPL Subpool of work area 
1 (1) 3 OPWLENTH Work area length 
4 (4) 8 OPWID Block ID—IDAOPWRK 
12 (C) 1 OPWFLGS1 Flag byte 1: 
| Peeeree OPWCAT Catalog open 
a eee OPWSCRA System CRA open 
val ewes OPWVVIC MSVI data set 
X XXXX Reserved 
13 (D) 1 OPWFLGS2 Flag byte 2: 
| ee OPWUCRA User CRA open 
eee OPWIXDT Index open as an ESDS 
ro ere OPWAIXDT Alternate index open for end use 
oe eee OPWDUMMY Open dummy data set 
XXXX Reserved 
14 (E) 1 OPWFLGS3 Flags for IDA0192F 
| reer OPWDAVAT Dummy AMBL added to VAT 
py ae OPWPUPGR Path also in upgrade set 
ant divas OPWUPGOP Upgrade set open 
en Beare OPWNOWRK MOD work area does not exist 
3 -JLaes OPWRSTRT Restart in progress 
seed: A XXX Reserved 
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OPEN Work Area (OPW)—Description and Format 


Offset 
15 (F) 


16 (10) 
20 (14) 
24 (18) 
24 (18) 
28 (1C) 
31 (1F) 


32 (20) 


32 (20) 
36 (24) 
37 (25) 
40 (28) 


44 (2C) 
45 (2D) 


46 (2E) 
48 (30) 


48 (30) 


52 (34) 


56 (38) 
60 (3C) 
64 (40) 
68 (44) 
72 (48) 


Bytes and 
Bit Pattern 


1 


Field Name 


OPWFLGS4 


OPWFULL 
OPWCINV 
OPWUPD 


OPWBIB 


OPWCOMWA 


OPWIDF 
OPWCACB 
OPWDCI 
OPWQ 


OPWDDC 
OPWGSR 
OPWLSR 
OPWFSTP 
OPWUBF 
OPWKSDS 
OPWESDS 
OPWDFR 


OPWVSMPL 


OPWVMANC 
OPWVMSP 

OPWVMLNG 
OPWVMADR 


OPWVMTYP 
OPWVMFLG 


OPWVMPGB 
OPWVMKES 
OPWVMKE7 


OPWVMSRB 
OPWVMNSL 
OPWVMTCB 


OPWVSMWA 


OPWVANCP 


OPWVTBLP 


OPWVCSLP 
OPWVCSLE 
OPWVHDRE 
OPWVRI13 
OPWVSAVE 


Description 
Authorization flags: 


Full access 
Control-interval access 
Update access 
Reserved 


Address of the BIB 

Address of Open common work area 
Cluster identifier 

Address of catalog ACB 

Control interval number of data component 
Open qualifier: 


Connect by DD name 

Opened for GSR 

Opened for LSR 

Opened for ICI 

Opened for user buffering 

Opened as a KSDS 

Opened as an ESDS 

Opened with deferred write option 


O/C/EOV Virtual Storage Manager 
parameter list 


Address of anchor block 
Subpool for direct request 
Amount of storage requested 


Address of storage acquired (zero, if storage 
not obtained) 


Request type 
Flag byte: 


Get storage on a page boundary 

Get storage in Key 5 

Get storage in Key 7 (if not key 5 or key 7, 
get storage in key 0 or problem program key) 
Special request block 

Do not build a CSL for this request 

Storage is owned by JOBSTEP TCB 
Reserved 


Reserved 


O/C/EOV Virtual Storage Manager work 
area 


Pointer to the address of the first HEB 
header element associated with this request 


Address of the request table used by 
GETSPACE routine 


Used to scan for a CSL entry 
Address of save list entry 
Address of header element 
Address of caller’s save area 


IDA0Q192M save area 
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OPEN Work Area (OPW)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description 
88 (58) 36 The following 12-byte field is repeated three - 
times: 
0 (0) 12 OPWVGSPL GET SPACE parameter list 
0 (0) 1 OPWVGSSP Subpool number 
1 (1) 3 OPWVGETL Length of acquired storage 
4 (4) 4 OPWVGSPT Address of acquired storage 
8 (8) 1 OPWVGFLG Flags for GET SPACE (see OPWVMFLG, 
above, for description of bit settings) 
9 (9) OPWVREQL Length of request 
124 (7C) 4 OPWVANCS Address of BIB anchor for sphere block 
requests 
128 (80) 8 OPWVLSAV SETLOCK save area 
128 (80) 4 OPWVRGI12 Save area for register 12 
132 (84) 4 OPWVRGI13 Save area for register 13 
136 (88) 8 OPWVFMPL FREEMAIN parameter list 
136 (88) 1 OPWVFMSP FREEMAIN subpool number 
137 (89) 3 OPWVFMLN FREEMAIN length 
140 (8C) 4 OPWVFEMPT FREEMAIN address 
144 (90) 20 OPWSAVE Addresses of save lists 
144 (90) 4 OPWCSL Address of core save list 
148 (94) 4 OPWESL Address of ENQ save list ‘ 
152 (98) 4 OPWPSL Address of page-fix save list J 
156 (9C) 4 OPWDSL Address of DEB save list 
160 (AO) 4 OPWSSL Address of swap save list 
164 (A4) 4 OPWCURPT Address of cluster being processed. This field 
can point to OPWBSECL (528(210)), 
OPWPTAIX (536(218)), OPWUPAIX 
(548(224)), and every 8 bytes thereafter, 
since OPWUPAIX is a repeating field. The 
format of current cluster information is 
described below by OPWCURCL. 
168 (A8) OPWXAMBL Address of current AMBL 
172 (AC) 4 OPWCAMBL The address of the existing AMBL for 
connecting to an existing structure 
176 (BO) 4 OPWBCON Address of base AMBL connecting to 
180 (B4) 4 OPWPCON Address of path AMBL connecting to 
184 (B8) 4 OPWBAMBL Address of AMBL for base 
188 (BC) 4 OPWPAMBL Address of AMBL for path 
192 (CO) 6 OPWCRA CRA volume serial number 
198 (C6) 1 Reserved 
199 (C7) 1 OPWCATTR MVS cluster attributes: 
XXXX XXX. Reserved 
oer 1 Page space data set 
200 (C8) 4 OPWUPT Address of upgrade table ) 
204 (CC) 4 OPWUACB Address of user ACB 
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OPEN Work Area (OPW)—Description and Format 


Offset 


208 (DO) 
212 (D4) 
216 (D8) 
220 (DC) 
224 (EO) 
228 (E4) 
232 (E8) 
236 (EC) 
240 (FO) 
241 (F1) 


242 (F2) 
243 (F3) 
244 (F4) 
296 (128) 
308 (134) 


564 (234) 
568 (238) 
568 (238) 
569 (239) 
572 (23C) 
573 (23D) 
576 (240) 
576 (240) 
577 (241) 


580 (244) 
581 (245) 
584 (248) 
585 (249) 


588 (24C) 


0 (0) 
0 (0) 
1 (1) 


4 (4) 
5 (5) 


Bytes and 
Bit Pattern 


4 


-& & ff F&F FF FS A 


—, 


52 
12 
256 


ww — CO WD mm WW — OO ff 


Field Name 


OPWWRKPT 
OPWDTWRK 
OPWIXWRK 
OPWCTCB 
OPWJSTCB 
OPWTIOT 
OPWBUFND 
OPWBUFNI 
OPWCSTRN 
OPWSTRNO 


OPWBSTRN 


OPWDACB 


OPWSFI 
OPWERMAP 


OPWSAVEA 


OPWBSECL 


OPWBDTCI 


OPWBIXCI 
OPWPTAIX 


OPWPDTCI 


OPWPIXCI 
OPWNOUPG 
OPW2YPLH 


OPWUPAIX 


OPWUDTCI 


OPWUIXCI 


Description 

Address of current AMB work area 
Address of data AMB work area 
Address of index AMB work area 
Address of current TCB 

Address of JOBSTEP TCB 
Address of TIOT entry 

Number of data buffers 

Number of index buffers 

Current string number 


Path string number, if path processing; 
otherwise, base string number 


Base string number, if base processing 
Reserved 

Dummy ACB for opening base 
Subfunction information 


Map of return codes to ACBERFLG, where 

return code rc is defined in OS/VS Message 
Library: VS2 System Messages for messages 
IECO70I1, IEC1611, IEC2511, and IEC252I. 


Return address save area 

Base cluster information 

Reserved 

Base data control interval number 
Reserved 

Base index control interval number 
Path alternate index information 
Reserved 


Path alternate index data control interval 
number 


Reserved 
Path alternate index control interval number 
Number of upgrade alternate indexes 


Address of PLHNXT for IDA0192Y and 
IDA0192Z 


The following 8-byte field, pointed to by 
OPWCURPT (164(A4)), is repeated once for 
each upgrade alternate index associated with 
the base cluster being processed. 


Upgrade alternate index information 
Reserved 


Upgrade alternate index data control interval 
number 


Reserved 


Upgrade alternate-index index control 
interval number 


Data Areas 347 


OPEN Work Area (OPW)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description 
The format of information about the cluster being processed (pointed to by OPWCURPT J 
128 (X‘80’)) is shown below: 
0 (0) 8 OPWCURCL Current cluster information 
0 (0) 1 OPWCFLGI1 Cluster flags (set by sphere Open): 

len ces OPWBASE Open base cluster 

a epee OPWPATH Open path alternate index 

ail s-tmag OPWUPGR Open upgrade alternate index 

wy eer OPWSVWRK Do not free AMB work areas 

een OPWPRTBL Partial control-block build 

eae. °.6. Reserved 
1 (1) 3 OPWCDCTI Data component control interval number 
4 (4) 1 OPWFLG2 Cluster flags (set by cluster Open) 

Leos OPWDOPEN Open indicator on in catalog for data 

Ay ee OPWMODWK — Module work area exists 

el (Raney OPWEMPUP Empty upgrade data set 

ed atae OPWERR2B Terminating error in IDA0192B 

Pe eee OPWIOPEN Open indicator on in catalog for index 

eee. 9,9.4 Reserved 

5 (5) 3 OPWCIXCI Index component control interval number 


PLH—Placeholder 


The PLH contains current information about a string of requests. This 

information includes positioning information, request options, and buffer 

location and status. The PLH is built by the Open routine and is pointed to by 

the AMB (AMBPH). The next PLH in the chain is pointed to by J 
PLHCHAIN. The number of PLH entries is the number given in STRNO in 

the ACB. (When a data set is shared, the number is the number in the first 

ACB opened for the data set.) When a Record-Management routine is 

processing a PLH, the PLH’s address is in register 2 (RPLH). 


Placeholder (PLH)—Description and Format 


Bytes and 

Offset Bit Pattern Field Name Description 

PLH Header 

0 (0) 1 PLHID Control block identifier, X‘30’ 

1 (1) 1 PLHCNT Number of PLH entries that follow the 
header 

2 (2) 2 PLHELTH Length of each PLH entry 

4(4) 4 PLHDRREQ Count of requests that have been deferred 

8(8) 2 PLHDRMAX Maximum number of placeholders (PLH 
entries) in concurrent use 

10(A) 2 PLHDRCUR Number of active placeholders 

12(C) 4 PLHIOSDQ Data-Set Management (I/O Support) 
deferral queue header 

PLH Entry 

0 (0) 1 PLHAVL Zero if the PLH entry is available 

1 (1) 1 PLHATV Zero if there are no active requests 


J 
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Placeholder (PLH)—Description and Format 


Offset 
2 (2) 


3 (3) 


4 (4) 


6(6) 


7(7) 


8 (8) 


Bytes and 


Bit Pattern 


Field Name 


PLHFLG1 


PLHEOVW 
PLHENDRQ 
PLHASKBF 
PLHSSR 
PLHRDEXC 
PLHASYRQ 
PLHDRPND 


PLHPFLG2 


PLHUPD 
PLHSQINS 
PLHKEYMD 
PLHADDTE 
PLHKRE 
PLHCIINS 
PLHSVADV 


PLHIWAIT 


PLHEFLGS 


PLHNOSPC 
PLHI1ST 


PLHSKPER 
PLHSRINV 
PLHNOADV 
PLHEODX 
PLHINVAL 
PLHDSCAN 


PLHRSTRT 
PLHFLG3 
PLHSRBSG 
PLHRAHD 
PLHSLVLD 
PLHBWD 
PLHRVRS 
PLHAFLGS 
PLHDRLM 
PLHVAMB 
PLHDBDC 


PLHIOSID 
PLHRABWD 


PLHACB 


Description 


Process flags, byte 1: 


The VSAM End of Volume routine is waiting 
The caller issued an ENDREQ request 

Less than maximum buffers 

The sequence set is stored with the data 
Read exclusive mode 

IRB execution needed 

A deferred request is pending 

Reserved 


Process flags, byte 2: 


The previous request was a GET-for-update 
Sequential insertion mode 

Keyed mode 

Add to the end processing 

End of key range indicator 

Control interval split insertion 

Save the PLHNOADYV field during Scan 
Data 

IDAWAIT indicator that an asynchronous 
test is in progress 


Exception flags: 


Byte 1: 

No space found—create mode 

This is the first request after the data set 
was opened 

Skip across the error control interval 
Spanned record is invalid 

Don’t advance the PLH 

The EODAD exit was taken 

Something is invalid 

Scan data after read exclusive 


Byte 2: 
Restart 
Reserved 


Flags: 


Update numbers in RDFs of spanned-record 
segments aren't the same 

Do read-ahead buffering 

Second level of the index is valid 

Previous request specified backward 
processing 

The I/O chain is reversed 

Reserved 


Flags: 


A direct request was issued during loading of 
an empty data set 

The AMB that points to the PLH is valid 
The PLH is from the VSAM resource pool 
I/O-Support ID 

IDAO19RA was entered for backward 
processing 

Reserved 


The next two fields comprise the DSID 
(Data-Set Identification): 


Address of the caller’s ACB 
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Placeholder (PLH)—Description and Format 


Offset 
12 (C) 


13 (D) 
14 (E) 
15 (F) 
16 (10) 
20 (14) 
24(18) 
28 (1C) 


32 (20) 


36 (24) 


40 (28) 


41 (29) 
42 (2A) 


43 (2B) 
44 (2C) 
48 (30) 


52 (34) 
56 (38) 
60 (3C) 
64 (40) 


68 (44) 
72 (48) 
74 (4A) 
76 (4C) 


80 (50) 


84 (54) 


108 (6C) 


112 (70) 


Bytes and 


Bit Pattern 


| 
xX‘ol’ 
X‘02’ 

| 

1 


= 


- + bf Fb 


- Fb fb EP fF 


bk N N fF 


24 


4 


4 
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Field Name 
PLHDSTYP 


PLHRMIN 
PLHFRCNT 
PLHBFRNO 
PLHMRPL 
PLHCRPL 
PLHDSIDA 


PLHCRBA 
PLHJORBA 


PLHJRNLL 


PLHJNRBA 


PLHJCODE 


PLHJGET 
PLHJPUT 
PLHJERS 
PLHJRBAC 


PLHRCODE 
PLHEOVR 


PLHARDB 
PLHLRECL 


PLHDBUFC 
PLHNBUFC 
PLHRECP 
PLHFSP 


PLHRDFP 
PLHRDFC 
PLHSRSID 
PLHDIOB 


PLHIIOB 
PLHARET 


PLHSAVE1 
through 
PLHSAVE6 


PLHAMB 


PLHCHAIN 


Description 


Data set type: 


Data 
Index 


Read threshold 

Number of free buffers 

Total number of buffers 

Address of the RPL header 

Address of the current RPL 

Address of the DSID (PLHACRB field above) 


Current RBA 
Old RBA—to support the JRNAD exit 
routine 


Length of the data—to support the JIRNAD 
exit routine 


New RBA—to support the JRNAD exit 
routine 


Entry code—to support the JRNAD exit 
routine 


JRNAD entry for GET 
JRNAD entry for PUT 
JRNAD entry for ERASE 
JRNAD entry for RBA change 


Indicates the previous request type 


End-of-Volume request code—indicates 
space allocation or volume mount 


Reserved 
Address of the current data ARDB 


Length of the record processed during the 
previous request 


Address of the current data BUFC 
Address of the next read BUFC 
Address of the current record 


Address of the first byte of free space within 
the record 


Address of the current RDF 
Replication count for the current RDF 
Spanned-record segment ID 

Address of the data IOMB 


Address of the index IOMB 
Return address to the I/O Manager’s 
Asynchronous Routine 


Six 4+byte register save areas—not 
to be used by Buffer Management, 
I/O Management, IDADRQ, or IDATJXIT 


AMB-address save area for IDADRQ and 
IDATJXIT 


Address of the next PLH in the chain 


Placeholder (PLH)—Description and Format 


Bytes and 
Bit Pattern 


Offset 
116 (74) 


118 (76) 
120 (78) 


164 (A4) 


168 (A8) 
172 (AC) 
176 (BO) 


180 (B4) 


184 (B8) 


188 (BC) 
192 (CO) 


196 (C4) 
200 (C8) 
200 (C8) 


204 (CC) 
208 (DO) 
232 (E8) 


236 (EC) 


240 (FO) 
242 (F2) 
244 (F4) 
248 (F8) 


252 (FC) 


256 (100) 


260 (104) 


264 (108) 


265 (109) 
268 (10C) 


272 (110) 


2 


32 


a & N WN 


> 


Field Name 
PLHRETO 


PLHRET1 


PLHASAVE 


PLHAR14 


PLHEOVPT 


PLHDDDD 
PLHNRBA 
PLHIBUFC 
PLHRBUFC 


PLHISPLP 
PLHIXSPL 


PLHSSRBA 
PLHHIREC 


PLHIXBFC 


PLHWAX 
PLHXPLH 


PLHLLOR 


PLHNOSEG 
PLHSRCSG 
PLHSLRBA 
PLHKEYPT 


PLHRRN 
PLHDRRSC 
PLHPARM 1 


PLHR13 


PLHDRMSK 


PLHECB 


PLHASCB 


Description 


Offset to the current register 14 save area in 
the push-down list (PLHRET1) 


Reserved 


Save area (push-down list) for 11 return 
registers (register 14) 


Beginning of save area for I/O 
Management’s Asynchronous Routine 


Save area for thirteenth return register 
Save area for fourteenth return register 


Address to which the Asynchronous Routine 
is to return 


Address of the RBA provided by the 
End-of-Volume routine 
RBA of the previous request 


Next RBA 
Address of the index BUFC 


RBUFC save area for IDADRQ and 
IDATJXIT 


Address of the IXSPL 
Space for one IXSPL 


RBA of the sequence-set control interval 
RBA of the high record 


Address of a BUFC for index 
Parameter area for index search 


Address of the work area for path processing 
Address of the PLH for the alternate index of 
the base cluster 


Address of the least length of the data record 
that contains all of the record’s key fields 


Number of segments in a spanned record 
Number of the segment being processed 
RBA of the second level of the index 


Address of the current key (PLHKEY at end 
of PLH entry) 
Previous relative record number 


Address of the deferred-request flag byte 


RPARM 1 save area for IDADRQ and 
IDATIXIT 


Register 13 save area for IDADRQ and I/O 
Management 


Mask to test for resources for a deferred 
request 


Reserved 


Address of event control block for 
cross-region post 


Address of address space control block for 
cross-region post 
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PSL~L—Page Save List 


Placeholder (PLH)—Description and Format 
Bytes and 


Offset Bit Pattern Field Name 
276 (114) 4 PLHERRET 
280 (118) 0 PLHEND 
280 (118) 28 PLHEXTEN 
280 (118) 4 PLHRESRI1 
284 (11C) 1 
285 (11D) 1 PLHBMWRK 
1 eee PLHBMRDF 
eee PLHBEUC 
rea ere PLHBMSOV 
eX XXXX 
286 (11E) 2 PLHRDCNT 
288 (120) 20 PLHBMSVI1 
through 
PLHBMSV5 
VL VL PLHKEY 


Description 


Address to which to return from an error (for 


cross-region post) 


Label for the end of the PLH entry before 
PLHEXTEN and PLHKEY 


Extension to the PLH for processing with 
shared resources (optional): 


Address of a serial resource being held 
Reserved 
Buffer-Management work flags: 


The RBA was found in the buffer pool (for 
SCHBFR macro) 

End of use chain 

Start-over flag 

Reserved 


Save area for AMBRDCNT 


Five 4-byte save areas 
for Buffer Management 


The current key, pointed to by PLHKEYPT 


The PSL contains a variable number of entries that describe the pages of 
virtual storage that have been fixed in real storage by Open. It enables Open 
to free these pages if an error prevents them from being freed normally. 


The PSL is pointed to by OPWA (called the ACB work area). There is no 


more than one PSL per data set. 


Page Save List (PSL)}—Description and Format 


Bytes and 
Offset Bit Pattern Field Name 
0 (0) 1 PSLSUBPL 
1 (1) 3 PSLLENTH 
4 (4) 8 PSLID 
12 (C) 4 PSLNXPTR 
16 (10) 8xn PSLENTRY 
16 (10) 4 PSLSTAD 
20 (14) 1 PSLFLG 
heen PSLFLGLT 
XXX XXXX 
21 (15) 3 PSLENDAD 
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Description 

Subpool number of the PSL 
Length of the PSL 
Identifier: ‘6IDAPSLb’ 
Zero 

Entries for pages fixed: 


Address of the beginning of the 
virtual-storage area that was fixed 


Flags: 


This is the last entry 
Reserved 


Address of the first byte beyond the 
virtual-storage area that was fixed 


J 


RPL—Request Parameter List 


The RPL contains user-request information and error feedback information. 
It also contains information required by GET and PUT macros. 


The RPL is created by the user with the RPL or the GENCB macro. 
Request Parameter List (RPL)—Description and Format 


Bytes and 
Offset Bit Pattern 
0 (0) 4 
0 (0) 1 
1 (1) 1 
2 (2) 1 
3 (3) 1 
4 (4) 4 
8 (8) 1 
| ae 
oe 
..XX XXXX 
9 (9) 3 
12 (C) 4 
12 (C) 1 
X..X XXXX 
13 (D) 3 
13 (D) 1 
X‘00’ 
X‘04’ 


Field Name 
RPLIDWD 
RPLID 
RPLSTYP 


RPLREQ 


RPLLEN 
RPLPLHPT 
RPLECB 


RPLWAIT 
RPLPOST 


RPLFDBWD 
RPLSTAT 


RPLCHKI 
RPLEDRQI 


RPLFDBK 


RPLRTNCD 
RPLERREG 


Description 
Identification word of the RPL: 
Control block identifier, X°00’ 


RPL subtype: 
X‘10’ = VSAM 
X‘20’ = VTAM 


Request type—when the user issues a VSAM 
macro, register 0 contains one of the 
following request-type codes; when VSAM 
processes the request, the request-type code 
in register O is transferred to the RPLREQ 
field (unless the request is CHECK or 
ENDREQ) 


0(0) GET request 

1(1) PUT request 

2(2) CHECK request 

3(3) POINT request 

4(4) ENDREQ request 

5(5) ERASE request 

6(6) VERIFY request 

8(8) Data preformat request 
9(9) Index preformat request 
10(A) Force I/O request 
11(B) GETIX request 

12(C) PUTIX request 

13(D) SCHBFR request 

14(E) MRKBER request 
15(F) WRTBER request 
Length of the RPL 


Address of the PLH 
Address of the external ECB, or an internal 
ECB: 


The event has not yet completed 
The event has completed 
Reserved 


Reserved, if RPLECB is an internal ECB, or 
the address of the external ECB 


Feedback work: 
RPL status flags: 


CHECK has been issued 
ENDREQ has been issued 
Reserved 


RPL feedback area (See ““Diagnostic Aids”’ 
for a list of RPL return codes and condition 
codes.) 


RPL return code 


Normal return 
Invalid control block 
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Request Parameter List (RPL)—Description and Format 


Offset 


14 (E) 
14 (E) 
15 (F) 
16 (10) 


18 (12) 
20 (14) 
24 (18) 
28 (1C) 


32 (20) 
36 (24) 
40 (28) 
40 (28) 


41 (29) 


Bytes and 
Bit Pattern 


X‘08’ 
X‘0C’ 
2 
l 


- fh BF N 
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Field Name 


RPLCNDCD 
RPLCMPON 
RPLERRCD 


RPLKEYLE 
RPLKEYL 


RPLSTRID 
RPLCCHAR 
RPLDACB 
RPLTCBPT 


RPLAREA 
RPLARG 
RPLOPTCD 
RPLOPT1 
RPLLOC 
RPLDIR 
RPLSEQ 


RPLSKP 
RPLASY 


RPLKGE 
RPLGEN 
RPLECBSW 


RPLOPT2 


RPLKEY 
RPLADR 
RPLADD 
RPLCNV 


RPLBWD 
RPLLRD 


RPLUPD 
RPLNSP 


Description 


Logical error 
Physical error 


RPL condition code 
Component issuing the code 
Error code 


Key length 


RPL string identifier 
Address of the control character 
Address of the caller’s ACB 


Address of the user’s TCB—this field is 
always zero fora VSAM RPL 


Address of the caller’s record area 
Address of the caller’s search argument 
Option flags 

Option flag byte 1: 


Locate mode 

Move mode 

Direct-search access 

Sequential access 

Skip sequential processing 
Asynchronous request 
Synchronous request 

Search key greater than or equal 
Search key equal 

Generic key 

Full key 

The RPLECB field contains the 
ECB’s address 


Option flag byte 2: 


Locate the record identified by a key 
Locate the record at the caller-specified 
relative byte address (RBA) 

Locate the control interval at the 
caller-specified RBA 

Process in backward direction 
Locate or retrieve the last 

record in the data set 

Update processing 

Note the string position 

Reserved 


Request Parameter List (RPL)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description 
42 (2A) 1 RPLOPT3 Option flag byte 3: 
5 eee RPLEODS End of the user’s output data set 
a Paar RPLSFORM Spool form on remote 
ey eee RPLBLK Block the records 
Fe | ene The records are unblocked 
gash tends RPLVFY UCS/FCB verify 
Sele RPLFLD UCS fold 
meray, ©, 3 RPLFMT Format type: 
we. OO. UCS load 
wae 01, FCB load 
wee LOD Reserved 
Peer (al Reserved 
Acetned 1 RPLALIGN Align the buffer and notify the operator 
ere 0 Do not align the FCB buffer loads 
43 (2B) 1 RPLOPT4 Reserved 
44 (2C) 4 RPLNXTRP Address of the next RPL in the chain 
RPLCHAIN 
48 (30) 4 RPLRLEN Length of the record 
52 (34) 4 RPLBUFL Length of the user’s buffer 
56 (38) 4 Reserved 
60 (3C) 8 RPLRBAR RBA return location 
60 (3C) 2 RPLAIXPC Alternate-index pointer count 
62 (3E) 1 RPLAIXID Alternate-index pointer type: 
> eee RPLAXPKP Pointer is: 
0 Prime-key pointer 
1 RBA pointer 
«XXX XXXX Reserved 
63 (3F) 1 Reserved 
64 (40) 4 RPLDDDD Relative byte address 
68 (44) 1 Reserved 
69 (45) 1 RPLACTIV CHECK not issued 
70 (46) 2 RPLEMLEN Error message length 
72 (48) 4 RPLERMSA Address of the error message area 


RPLE—Request Parameter List Extension 


An RPLE is built and appended to each ISAM Interface RPL when the user’s 
ISAM program opens a VSAM cluster. The RPLE contains the address of the 
IICB, a register save area, a linkage to other RPLs in the ISAM Interface 
RPL pool, and a pointer to the ISAM DECB. 


Request Parameter List Extension (RPLE)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 4 RPLIICB Address of the IICB 
4 (4) 4 RPLDECB Address of the DECB— if the field contains 


zeros, the RPL has not been assigned to a 
DECB (BISAM only) 
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8 (8) 


12 (C) 


16 (10) 


17 (11) 
20 (14) 
24 (18) 


SRB—Service Request Block 


RPLITBFR 


RPLRPLPT 


RPLITTSB 


RPLSAVE 
RPLSAVE2 


Address of the ISAM Interface buffer 
associated with the RPL (the buffer is 
required for locate mode processing, data 
only retrieval, dynamic buffering, and 
BISAM stand-alone write) 


Address of the next RPL in the ISAM 
Interface RPL pool—if the RPL is the last 
RPL in the pool, this field contains zeros 


Test-and-set (TS) byte—this field is used to 
indicate the assignment of the RPL toa 
BISAM DECB 


Reserved 
Register save area 


Register save area 


The SRB is used by the VS2 I/O Supervisor to dispatch I/O processing for a 
request. It identifies the address space in which processing is to be done. 


The format of the SRB is given in OS/VS2 Data Areas. 


SSL—Swap Save List 


The SSL contains up to 16 entries that identify control blocks that are to be 
chained after Open has otherwise completed successfully. Deferring chaining 
makes it unnecessary to unchain the control blocks should Open fail. 


Open uses the Compare-and-Swap instruction to chain or alter storage that is 
subject to simultaneous alteration by two or more tasks. 


The SSL is pointed to by OPWA (called the ACB work area). Additional 
SSLs are chained as required. 


Swap Save List (SSL)—Description and Format 


Offset 
0 (0) 
1 (1) 
4 (4) 
12 (C) 


16 (10) 
18 (12) 
20 (14) 
20 (14) 


24 (18) 
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Bytes and 
Bit Pattern 


1 


3 
8 
4 


Field Name 
SSLSUBPL 
SSLLENTH 
SSLID 
SSLNXPTR 


SSLACEN 


SSLENTRY 
SSLSWPTR 


SSLSWAP 


Description 

Subpool number of the SSL 
Length of the SSL 
Identifier: ‘bIDASSLb’ 


Address of the next SSL (zero for the last 
SSL in the chain) 


Number of active entries 
Reserved 
Entries for control blocks to be chained: 


Address of the word in which SSLSWAP is to 
be placed 


The value that is to be placed at the address 
given is SSLSWPTR 


UPT—Upgrade Table 


The UPT describes the upgrade set of a base cluster. It contains an entry for 
each alternate index in the upgrade set. It is pointed to by the BIB (BIBUPT). 


Upgrade Table (UPT)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description 
UPT Header 
0 (0) 4 UPTHDR Header: 
0 (0) 1 UPTID Control block identifier, X‘45’ 
1 (1) 1 UPTFLGO Flags: 
| ere UPTPWS Continue with scan 
XXX XXXX Reserved 
2 (2) 2 UPTLEN Length of the UPT 
4 (4) 4 UPTNEW Address of the new alternate-index record 
8 (8) 4 UPTOLD Address of the old alternate-index record 
12 (C) 1 UPTRSC Resource byte—used to serialize updates 
13 (D) 1 UPTNOENT Number of alternate indexes in the upgrade 
set (and of entries in the UPT) 
14 (E) 2 UPTLLEN Largest sum of key length plus the key’s 
relative position in a data record 
16 (10) 72 UPTSA Save area: 
16 (10) UPTWORKI1 Work area 
20 (14) UPTLSA Last save area 
24 (18) 1 UPTBEREG RPLERREG value for the base cluster 
25 (19) 1 UPTBERCD RPLERRCD value for the base cluster 
26 (1A) Reserved 
28 (1C) 4 UPTR14 Address to which IDA019R4 returns after 
I/O is issued for upgrading 
32 (20) 56 UPTRI5 Rest of save area 
UPT Entry 
0 (0) 12 UPTAXENT Entry for an alternate index in the upgrade 
set: 
0 (0) 4 UPTRPL Address of the upgrade RPL 
0 (0) 1 UPTF1ILOP Last operation against the upgrade ACB 
4 (4) 2 UPTFLG1 Flags: 
Byte 1: 
| Peer UPTFILST This is the last entry in the UPT 
ohe.4 UPTFIATV This entry is active for an upgrade operation 
Ae tee UPTFINUK The alternate index can have nonunique keys 
Fee eee UPTF1INOP The alternate index is not open 
“2 hace UPTFINRF A no-record-found error has occurred 
.X.. UPTFIKEY The key being processed is: 
0 Old 
1 New 
me Ie UPTFIRTY The last operation is being retried 
seal UPTFIUPG The alternate index is being upgraded 
Byte 2: 
Lssccetes UPTFIBKO An upgrade operation is being undone 
(backed out) 
See UPTFILOG A logical error has occurred 
Pr [eee UPTF1PHY A physical error has occurred 
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Upgrade Table (UPT)—Description and Format 
Bytes and 


VAT—Valid-AMBL Table 
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Offset Bit Pattern Field Name Description 
fe eer UPTFIERA The operation requiring upgrade was Jd 
deletion (ERASE) 
ad eee UPTF1IPNU The operation requiring upgrade was 
insertion 
ee UPTFIPUD The operation requiring upgrade was update 
heoee Reserved 
6 (6) 2 UPTRKP Relative alternate-key position in a base 
record 
8 (8) 1 UPTPASS The number of this upgrade operation (pass 
through the upgrade set) 
9 (9) 1 UPTLNCDE Length of key, minus 1 
10 (A) 2 UPTBG Length of RPLAREA field 


The VAT is used to check the validity of each AMBL that is built for 
processing a base key-sequenced cluster. It contains the address of each 
AMBL. The first VAT is pointed to by the JSCB (JSCBSHR). 


Valid-AMBL Table (VAT)—Description and Format 


Bytes and 

Offset Bit Pattern Field Name Description 

0 (0) 4 VATHDR Header: 

0 (0) 1 VATID Control block identifier, X‘11’ 

1 (1) 1 Reserved 

2 (2) 2 VATLEN Length of the VAT > 

4 (4) 4 VATNEXT Address of the next VAT 

8 (8) 8 VATVSRT Used to update the use count and address of 
the VSAM shared resource table at the same 
time (with the CDS instruction) 

8 (8) 4 VATVUSE Use count in the VSRT 

12 (C) 4 VATVPTR Address of the VSRT 

16 (10) 4 VATPAMBL Address of the first AMBL in the primary 
chain 

20 (14) 2 VATVC Used for checking validity of AMBLs 

20 (14) 1 VATVRT The number of this VAT on the chain 

21 (15) 1 VATENO Number of entries in this VAT 

22 (16) 2 Reserved 

24 (18) 4 VATNAE Number of active entries in this VAT 

28(1C) 4x16 VATAMBL Addresses of valid AMBLs 


VCRT—VSAM Checkpoint /Restart Table 


The VCRT is used by VSAM checkpoint/restart. The VCRT, which is 
mapped by IDAVCRT, is suballocated from VCRCORE in IDAQ606C. It 
contains a count, by entry type, of each entry associated with the VCRT. 
There are three entry types: open, upgrade, and index. The VCRT is pointed 
to by the BIB (BIBVCRT). 


VSAM Checkpoint/Restart Table (VCRT)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name _ Description 
0 (0) 1 VCRID Control block ID—X‘80’ 
1 (1) 1 VCRFLAGI Flag bytes: 
Las sae: VCRUPGSW Entry type: 
1 = Upgrade; 
0 = Open 
Gls, Saahs VCRLSR Local shared resources specified 
Bets: cei VCROUT Output ACB is open 
.X XXXX Reserved 
2 (2) 2 Reserved 
4 (4) 8 VCRIDNM  VCRT control block name—IDAVCRT 
12 (C) 4 VCRCOREH Address of first VCRCORE header 
16 (10) 2 VCROPNCT Open entry count 
18 (12) 2 VCRUPGCT Upgrade entry count 
20 (14) 2 VCRIDXCT Index entry count 
22 (16) 2 Reserved 
24 (18) 4 VCRCISIZ _ Size of the largest control interval in the 
sphere 
28 (1C) 4 VCRSPHPT Address of sphere block HEB save area 
32 (20) 4 VCRRBUF Address of the repositioning buffer, or 
zeros 
36 (24) 4 VCROPN Address of first VCRT open entry 
40 (28) 4 VCRUPG Address of first VCRT upgrade entry 
44 (2C) 4 VCRIDX Address of first VCRT index entry 


The VCRT open entry is used by VSAM restart to rebuild the control blocks needed for 
a valid restart. The format is: 


0 (0) 4 VCRHEBS __ Address of the HEB save area (zeros if 
the cluster is part of the upgrade set) 
4 (4) 4 VCRAMBL Address of the user’s AMBL 


The VCRT upgrade entry points to the upgrade AMBL and the HEB save areas to be 
processed by VSAM restart. The entry exists only if the upgrade set for this data set 
was open at checkpoint time. The format is: 


0 (0) 4 VCRUHEBS Address of the HEB save area 
4 (4) 4 VCRUAMBL Address of the upgrade AMBL 


The VCRT index entry contains ICWA and buffer addresses for the index level it 
represents. The entry exists only if the base data set is a key-sequenced data set open 
for create mode processing. There is one entry for each index level that exists at open 
time. The format is: 


0 (0) 4 VCRICWA _ Address of the ICWA 
4 (4) 4 VCRBUFPT Address of the associated buffer 
VCRCORE is created by VSAM checkpoint (IDAOCO6C) and freed by the VSAM 
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VSAM Checkpoint/Restart Table (VCRT)— Description and Format 


Bytes and 
Offset Bit Pattern Field Name __ Description 





checkpoint/restart cleanup routine in IDAO196C. The first VCR core header is pointed to 
by VCRCOREH (12(C)) in the VCRT. The format is: 


0 (0) VCRCHDR VCR core header 


0 (0) 8 VCRCNM VCRCORE ID—VCRCORE 
8 (8) 4 VCRCNEXT Address of next VCR core header 
12 (C) 4 VCRCDESC Cleanup information 
1 VCRCSP Subpool number containing this block 
3 VCRCLEN _ Length of this block 
16 (10) 4 VCRCPTRA Address of first available byte in this 
block 
20 (14) 4 VCRCLENA Length of available storage in this block 
24 (18) VL VCRCDATA Storage for data (minimum 4072 bytes) 


The HEB save area is pointed to by the open (VCRHEBS) or upgrade (VCRUHEBS) 
entries of the VCRT. The format of the save area is: 


0 (0) 8 VCRHHDR Header for each CMB entry (CMBPTRS) 
or for BIBSPHPT 
0 (0) 2 VCRHNENT Number of entries in header element 
chain 
2 (2) 1 VCRHFLG Flag byte: 
| eer VCRHFCON This is a continuation of a previous CMB 
entry 
| ee VCRHFREL Issue FREEMAIN at restart time 
.XX XXXX Reserved 
3 (3) 1 VCRHCID _ Relative CMB entry number, or 0 for J 
*  BIBSPHPT 
4 (4) 4 VCRHNEXT Address of next HEB save area header for 
cluster 
8 (8) The following fields are repeated once for 
each entry in the header element chain 
0 (0) 20 VCRHENT Header element saved at checkpoint as 


defined by IDAHEB mapping macro 
0 (0) 8 VCRHEFMN FREEMAIN information: 
0 (0) 1 VCRHESP — Subpool number 
1 (1) 3 VCRHELN _esLength of storage 
4 (4) 4 VCRHESPT Address of storage 


8 (8) 12 Remaining content of header element 
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VGTIT—VSAM Global Termination Table 


The VGTT identifies global virtual storage that may need to be specially freed 


if an error prevents it from being freed normally. There are four types of 
VGTTs for: 


Keeping track of an address space’s use of a global VSAM resource pool 
(for processing with global shared resources) 


Keeping track of certain control blocks (sets of IOSB, SRB, and PFL) that 
are kept in global storage for processing with local shared resources (the 
normal pointers to these control blocks are in unprotected local 
storage—the VGTT is in global storage, adjacent to them) 


Keeping track of control blocks during the opening of a catalog, a catalog 
recovery area, or the mass storage volume inventory data set (all of whose 
control blocks are kept in global storage 


Keeping track of certain control blocks (sets of IOSB, SRB, and PFL) that 
are kept in global storage for processing a user data set and all related data 
sets (such as alternate indexes) 


The VGTT is pointed to by the ASCB (address space control block). It is 
chained to the next VGTT for the address space. 


VSAM Global Termination Table (VGTT)—Description and Format 


Bytes and 

Offset Bit Pattern Field Name Description 

0 (0) 4 VGTTID Control block identifier: ‘VGTT’ 

4 (4) 1 VGTTTYPE VGTT type indicator: 

| egeaee VGTTRSTR VGTT is for restart 
eee VGTTGSR VGTT is for processing with global shared 
resources—VGTTVUSE is used 
Sedlis wees VGTTLSR VGTT is for processing with local shared 
resources 
ata saat VGTTCTLG VGTT is for opening a catalog, a catalog 
recovery area, or the mass storage volume 
inventory data set 
Fee ee VGTTOPEN VGTT is for processing a user’s data set 
without shared resources 
. XXX Reserved 

5 (5) 1 Reserved 

6 (6) 1 Reserved 

7 (7) 1 Subpool number of the VGTT and of the 
global storage it protects 

8 (8) 4 VGTTSIZE Length of the VGTT 

12 (C) 4 VGTTNEXT Address of the next VGTT (zero for the last 
VGTT in the chain) 

16 (10) 4 VGTTBIB Address of the base information block for the 
user’s data set and all related data sets (such 
as alternate indexes) 

20 (14) 4 VGTTVUSE For a VGTT for global shared resources, the 
use count that was contributed by the 
processing of the user’s data set and all 
related data sets. 

24 (18) 4 VGTTPSB Address of the protected sphere block (which 


contains HEBs for use by Virtual-Storage 
Management) 
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VSAM Global Termination Table (VGTT)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description j 
28 (1C) 4 Reserved 
32 (20) VL VGTTCORE For a VGTT for local shared resources, the 


virtual-storage area the VGTT protects 


VIOT—Valid-IOMB Table 


The VIOT contains the address of each valid IOMB within a VSAM resource 
pool (for processing with shared resources). It is pointed to by the VSRT 
(VSRTVIOT) and by each AMB associated with the resource pool. 


Valid-IOMB Table (VIOT)—Description and Format 
Bytes and 
Offset Bit Pattern Field Name Description 
0(0) 4 VIOHDR Header 
0(0) | VIOID Control block identifier, X°16’ 
1(1) 1 Reserved 
2(2) 2 VIOLEN Length of the valid-IOMB table 


4(4) 4xn VIOPTR Address of a valid IOMB; this field is 
repeated n times 


VMT—Volume Mount Table 


The VMT identifies and describes volumes that are mounted for a base 
cluster and all clusters associated with it for processing. There is a VMT for 
each device type. The first VMT is pointed to by the BIB (BIBVMT). J 


Volume Mount Table (VMT)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 4 VMTHDR Header: 
0 (0) | VMTID Control block identifier, X*12’ 
1 (1) 1 Reserved 
2 (2) 2 VMTLEN Length of the VMT 
4 (4) 4 VMTNXT Address of the next VMT 
8 (8) 2 VMTNOVOL Number of volume entries ( 1) in the VMT 
10 (A) 3 Reserved 
13 (D) 3 VMTDEV Device information: 
13 (D) 1 VMTDVOPT Device options 
14 (E) 2 VMTDVTYP Device class and type 
16 (10) 16x 7 VMTVOL Volume entry for a volume to be mounted: 
16 (10) 4 VMTUSECT Use count 
20 (14) 1 VMTVFLGI Volume flags: 
| epee VMTOPEN The volume is being processed by Open 
.XXX XXXX Reserved 
21 (15) 1 Reserved 
22 (16) 6 VMTVLSER The volume’s serial number 
28 (1C) 4 VMTUCB Address of the UCB for the volume 
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VSRIT—VSAM Shared Resource Table 


The VSRT contains the addresses of buffer pools and PLH pools in the 
resource pool and addresses of various control blocks built during the 
processing of a BLDVRP macro. For local shared resources (LSR), the VSRT 
is pointed to by the VAT (VATVPTR),; for global shared resources (GSR), it 
is pointed to by the AMCBS (CBSVPTR), which is described in OS/VS2 
Catalog Management Logic. 


VSAM Shared Resource Table (VSRT)—Description and Format 


Offset 
0 (0) 
1 (1) 
2 (2) 
4 (4) 
12 (C) 


14 (E) 


15 (F) 


16 (10) 
20 (14) 
24 (18) 
28 (1C) 


32 (20) 
36 (24) 
36 (24) 


37 (25) 
40 (28) 


41 (29) 


Bytes and 
Bit Pattern 


1 


ww co Nn — 


- + ff Ff 


Field Name 
VSRTBKID 


VSRTLEN 
VSRTID 
VSRTFLGS 


VSRTGSRF 
VSRTLSRF 
VSRTIOBF 


VSRTBFRF 


VSRTKL 


VSRTSTRN 


VSRTPLHH 
VSRTBUFH 
VSRTCPAH 
VSRTWAH 


VSRTVIOT 
VSRTCSL 
VSRTCSLF 


VSRTCSFX 
VSRTCSVS 
VSRTCSBF 
VSRTCSPF 
VSRTCSWS 


VSRTCSPL 
VSRTCSIO 
VSRTCSBH 


VSRTCSAD 
VSRTCSSP 


VSRTCSLN 


Description 

Control block identifier, X*°15’ 
Reserved 

Length of the VSRT 

Visual identifier, ‘IDAVSRT®6’ 
Flags: 


Byte 1: 

Global resource pool 

Local resource pool 

I/O-related control blocks are fixed in real 
storage 

Buffers are fixed in real storage 

Reserved 


Byte 2: 
Reserved 


The maximum key length of the data sets 
that are sharing the resource pool 


The total number of placeholders required 
for all the data sets (specified in BLDVRP) 


Address of the PLH header 
Address of the BUFC header 
Address of the CPA header 


Address of the working storage header 
(WSHD) 


Address of the valid-IOMB table 
Entries for gotten storage: 
Flags: 


The storage is fixed in real storage 

The storage contains the VSRT 

The storage contains a buffer 

The storage contains the page fix list 
The storage is for a work area (working 
storage) 

The storage contains PLHs 

The storage contains IOMBs 

The storage contains a buffer 


Address of the storage 


The number of the subpool the storage is 
located in 


Length of the storage 
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WAX—Work Area for Path Processing 


The WAX contains addresses and other information required for processing a 
path. It is pointed to by the PLH (PLHWAX). 


Work Area for Path Processing (WAX)—Description and Format 


Bytes and 
Offset Bit Pattern 
0 (0) 1 
1(1) 1 
| Ser 
lee 
| (ee 
wooX XXXX 
2 (2) 2 
4 (4) 
6 (6) 
8 (8) 4 
12 (C) 4 
16 (10) 
20 (14) 
24 (18) 4 
28 (1C) 4 
32 (20) 4 
36 (24) 4 
40 (28) 4 
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Field Name 
WAXID 
WAXFLGI1 
WAXSRAB 
WAXPUG 


WAXPS 


WAXLEN 
WAXPL 


WAXKXXXX2 
WAXIRPL 


WAXURPL 
WAXRCDA 
WAXXPTR 


WAXEPTR 


WAXBPLH 
WAXSRAA 
WAXSRAL 
WAXKXXXX3 


Description 
Control block identifier, X°73’ 
Flags: 


Catalog recovery area built in system storage 
The alternate index in the path is in the 
upgrade set 

The last operation against the path was a 
sequential PUT 

Reserved 


Length of the WAX 


Length of the alternate-index record’s 
pointers to base records 


Reserved 


Address of the inner (‘““dummy”) RPL that is 
used to gain access to the alternate index 


Address of the user’s RPL 
Address of the alternate-index record 


Address of the current alternate-index 
pointer to a base record 


Address of the byte beyond the last 
alternate-index pointer 


Address of the PLH for the base cluster 
Address of the saved-record area 
Length of the saved-record area 


Reserved 


J 





C 


WS HD—Working Storage Header 


The WSHD describes up to four blocks of storage used for work areas 
(working storage). It is pointed to by the AMB (AMBWSHD). 


Working Storage Header (WSHD)—Description and Format 


Offset 
0 (0) 
1 (1) 


2 (2) 
4 (4) 
4 (4) 
8 (8) 
18 (12) 
20 (14) 
24 (18) 
28 (1C) 


28 (1C) 
32 (20) 


32 (20) 
32 (20) 


33 (21) 
36 (24) 
40 (28) 


42 (2A) 


43 (2B) 


Bytes and 
Bit Pattern 


1 
1 


16x4 


12 


Field Name 
WSHDID 
WSHDPOOL 


WSHDLEN 
WSHDNEXT 
WSHDGMTB 
WSHDGMWA 
WSHDNUS 
WSHDGMRA 
WSHDOCHN 
WSHDSLT 


WSHDSAD 
WSHDSGMW 


WSHDSFM 
WSHDSFSP 


WSHDSFLN 
WSHDSONX 
WSHDSBV 


WSHDSFLG 
WSHDSFNO 


WSHDSBM 


Description 
Control block identifier, X'44 


The number of the subpool in which the 
WSHD is located 


Length of the WSHD 

Address of the next WSHD 

GETMAIN resource byte 

GETMAIN work area 

Number of used slots (entries) in the WSHD 
GETMAIN result (return code) 

Address of ordered slot chain 


Slot (entry) for each block of working 
storage: 


Address of the storage block 


Work area for the GETMAIN for the storage 
block: 


FREEMAIN field for the DLVRP macro: 


The number of the subpool in which the 
storage block is located 


Length of the storage block 
Address of the next slot on ordered slot chain 


Number of bytes represented by each bit in 
WSHDSBM 


Slot flags: 


The storage block has no bytes available 
Reserved 


Bit mask (each bit indicates whether the 
bytes it represents are used—1, or not—0O) 
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DIAGNOSTIC AIDS 


This chapter provides several aids that can be useful when you are trying to 
diagnose difficulties with VSAM modules. These aids include: 


A description of OS/VS2 VSAM Cross Reference, which is published on 
microfiche cards. 


A list of messages issued by VSAM, with a list of the module(s) causing 
the message to be issued and a list of function codes for Open, Close, and 
End of Volume. 


A list of macros that VSAM uses and their functions. 


A description of GTF, how VSAM requests it, and what it provides in the 
way of VSAM APAR information. 


A list of return codes. 

A description of Virtual-Storage Management and its control blocks. 
A description of Open, Close, and End-of-Volume diagnostics. 

A list of ABENDs issued by VSAM. 


Additional aids can be found in other parts of the book and in the program 
listings. These include: 


Register contents on entry to a module, which are under “INPUT” in the 
module prologues. 


Use of registers and equated names for registers, which can be found under 
“NOTES” in the module prologues. 


Error codes, which are under ‘““EXIT-ERROR’”’ in the module prologues. 


A list of modules, their external procedure names, their component, and 
their associated method of operation diagrams, which is in the ‘“Module 
Directory.” 


A list of external procedure names and their modules, which is in the 
“External Procedure Directory.” 


Definitions of terms and abbreviations used in the book, which are in the 
“Glossary.” 


Page references for the subjects covered in the book, which are in the 
“Index.” 


Microfiche Cross-Reference Aids 


OS/VS2 VSAM Cross Reference (microfiche) contains valuable 
cross-reference information. Three reports are available: 


Symbol Where Used Report 
Macro Where Used Report 
Control Flow Report 
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How to Read the Symbol Where Used Report 
The “Symbol Where Used Report” contains three kinds of information. 





¢ A list of symbolic names. This includes field names, symbolic address 
names, return-code names, constant names, and flag-bit names, in 
alphabetic order from top to bottom. 


The lower-right corner of each page contains the first and last names listed 
on the page. 


e« A list of modules that refer to each symbolic name, in alphabetic order 
from left to right. 


e A code indicating how each module refers to the symbolic name: 


W Write The data field or bit value was modified by at least one 
line of code in this module. If the module contains a 
statement, ‘““A = B’”’ (that is not part of an IF statement), 
then the module’s use of “A” is to modify it. 


R_ Read The data field or value was referred to by at least one line 
of code in this module. If the module contains a statement 
“A = B,” then the module’s use of ‘‘B’’ is to refer to it. 


C Compare The data field or value was compared with another field. 
If the module contains a statement, “If A=B, THEN...,” 
then the module’s use of “‘A”’ is to compare it with “B.” 
(The module’s use of ‘‘B”’ is to refer to it, not to compare 
it.) 


Other codes are explained in the “Access Codes”’ at the bottom of each page 
in the table. 





How to Read the Macro Where Used Report 
The ‘“‘Macro Where Used Report” contains three kinds of information. 
e A list of macro names in alphabetic order from top to bottom. 


The lower-right corner of each page contains the first and last macros 
listed on the page. 


¢ A list of the modules and macros that issue each macro in alphabetic order 
from left to right. 


e The total number of times a macro is issued and the number of times each 
module in the list issues it. 


How to Read the Control Flow Report 


The middle of each page of the ‘Control Flow Report” contains an 
alphabetic list of all modules and procedures. To the left of each item are 
listed (under ‘“FROM”’) all modules and procedures from which it gets 
control; to the right are listed (under ““TO”’) all modules and procedures to 
which it gives control. 


Next to each item on the left and on the right is a code (under “‘VIA’’) that 
indicates how control is passed. A key to the meaning of each code is given at 
the bottom of each page. 


Unfortunately, control passed by way of a branch instruction is not indicated ) 
by the report. 
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Messages 


Message 
Number 


Message 
Text 


Messages IDA001 through IDA025 refer to an incorrectly coded macro. 


IDA001 
IDA002 
IDA003 
IDA004 
IDA005 
IDA006 
IDA007 


IDA008 
IDA009 


IDA010 
IDAO11 
IDAO018 


IDAO19 
IDA020 


IDAOZ2I 


IDA022 


IDA024 


IDA025 


IECOO1A 
IECO03E 


IECO14E 
IECO70I 


IECIOIA 
IECIIE 
IEC1591 
IEC1611 


INVALID POSITIONAL PARAMETER, xxx - IGNORED 

xxx KEYWORD REQUIRED - NOT SPECIFIED 

INVALID VALUE, yyy, SPECIFIED FOR xxx KEYWORD 

xxx KEYWORD NOT VALID FOR EXECUTE FORM - IGNORED 
INVALID OR DUPLICATE SUBLIST ITEM FOR xxx KEYWORD, yyy 
xxx VALUE, yyy, NOT VALID FOR LIST FORM 

LOGIC ERROR IN MACRO xxx 


INCOMPATIBLE SUBLIST ITEMS, yyy AND zzz, FOR xxx KEYWORD 
xxx CONTROL BLOCK KEYWORDS SPECIFIED - ONLY ONE 
ALLOWED 


EXIT ADDRESS REQUIRED FOR xxx KEYWORD - NOT SPECIFIED 
xxx IS NOT A VALID yyy KEYWORD - IGNORED 


VTAM KEYWORD, xxx, SPECIFIED WITHOUT SPECIFYING 
AM=VTAM 


KEYWORDS xxx AND yyy ARE INCOMPATIBLE 


VTAM SUBLIST ITEM, xxx, SPECIFIED FOR yyy KEYWORD 
WITHOUT SPECIFYING AM=VTAM 


xxx and yyy KEYWORDS MUST BE SPECIFIED TOGETHER BUT 
ONE IS MISSING 


CONFLICTING SUBLIST ITEMS WERE SPECIFIED FOR xxx 
KEYWORD 


xxx, A VSAM KEYWORD SPECIFIED FOR A NON-VSAM CONTROL 


BLOCK 


www, yyy, 2zz CONFLICTING SUBPARAMETERS IN xxx KEYWORD, 


www ASSUMED 


Detected Issued 

By By 
M ddd,ser,jjj,sss,dsn IDA0192V IDA0192V 
R ddd,ser, jjj,sss, IDA0192V IDA0192V 
[.SPACE=PRM] ,dsn 
D dddd IDA0192V IDA0192V 
rc[(sfi)]-ccc,jjj,sss,ddn, IDA0192D IDA0192P 
ddd, vol,cin,dsn, cat IDA0192S 
(IECO70I is an End-of-Volume IDAO0192V 
message.) IDA0557A 

IFGO551F 
M ddad,ser, jjj,sss,dsn IGGOCLBL IDAO0192V 
D, ddd,ser IGGOCLBL IDAO0192V 
E13-rc,mod, jjj,sss,ddn [-#], ddd 
rc[(sfi)]-ccc, jjj, sss, ddn, IDA0192A IDA0192P 
ddd, vol, cin, dsn, cat IDA0192C 
(IECI6II is an Open message.) IDA0192D 

IDAO192S 

IDA0192V 

IDA0192Z 

IDA0192A 

IFGO192A 
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Message 
Number 


TEC2511 


TEC252I1 


IEC3311 
TEC3321 
TEC3331 


TEF4471 


IEF 4481 


TEF449] 


THJOOO! 
THJOO11 
THJ002I 
THJ0041 
THJOOS1 
THJOO6I 
THJ0071 


THJO081 
THJO0091 
THJO101 


Function Codes for VSAM Open, Close, and End-of-Volume Messages 


Message 
Text 


rc[(sfi)]-ccc, jjj,sss,ddn 
ddd, vol, cln, dsn, cat 
(IEC251I is a Close message.) 


re[(sfi)]-ccc, jjj,sss,ddn, 
ddd, vol, cin, dsn, cat 
(IEC252I is a Close 
(TYPE=T) message.) 


rc-crs, jjj,sss,func,mmm 
func[func...] 
terr,xx,cat, yyy 


IEF175SIAMP KEYWORD a”nnnnnnn 
DUPLICATE OR CONFLICTING 
PARM STEP NOT EXECUTED 


AMP KEYWORD aamnnannn IS 
INVALID STEP WAS NOT 
EXECUTED 


AMP KEYWORD annnannan VALUE 
xxxxxx IS TOO LARGE STEP 
NOT EXECUTED 


AMP KEYWORD annannnnn REQUIRES 
A DECIMAL VALUE STEP NOT 
EXECUTED 


CHKPT {jj (ddn) NOT TAKEN (xx) 
jij (ddn,ddd, vol) INVLD checkid (xxx) 
Jjj (ddn,ddd, vol) ERROR checkid (xxx) 
jij (ddn, ddd, vol) CHKPT checkid 

jij. (ddn, ddd, vol) ENQS checkid 

Jji RESTARTING at xxxxxx yyyyyy 


RESTART NOT SUCCESSFUL FOR 
dij (xxx [,cuu]) 


jji RESTARTED 
ERROR ON dan 


CHECKPOINT RESTART OF JOB 
jij ABENDED 


Detected 
By 


IDAOQCEA2 


IDA0192C 
IDA0192D 
IDA0192S 
IDA0192V 
IDA0200T 
IFGO0200V 


IDA0192C 
IDA0192D 
IDA0192S 
IDA0192V 
IDA0231T 
IGC0002C 


IEFVAMP 


TEFVAMP 


IEFVAMP 


IDA0A05B 


Issued 
By 


IDA0192P 





a 


IDA0192P 


When an error occurs during Open, Close, or End-of-Volume processing for a 
VSAM data set, the message that is issued will contain (besides error 
identification, job, step, and DD names, device address, volume serial 
number, and names of cluster, data set, and catalog) a field, ccc, that contains 
a function code. The following lists these function codes and ties each to the 
module that detected the error and the operation being performed when the 
error was detected. 
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Function 
Code 


Open 
1 
2 


Oo eo nN KH vA Sf W 


10 


20 
21 
22 
23 
30 
31 


41 
42 
43 
50 
51 
52 
53 
54 


61 
62 
63 
70 
71 
80 
81 
82 
83 
84 
85 
87 


Module that 
Detected 
Error 


IDA0192C 
IDA0192C 


IDA0192C 
IDA0192C 
IDA0192C 
IDA0192C 
IDA0192C 
IDA0192C 
IDA0192C 
IDA0192C 
IDA0192C 
IDA0192V 
IDA0192V 
IDA0192V 
IDA0192V 
IDA0192S 
IDA0192S 
IDA0192D 
IDA0192D 
IDA0192D 
IDA0192D 
IDA01922 
IDA0192Z 
IDA0192Z 
IDA01922Z 
IDA0192Y 
IDA0192B 
IDA0192B 
IDA0192B 
IDA0192B 
IDA0192W 
IDA0192W 
IFG0193A 
IDA0192A 
IDA0192A 
IDA0192F 
IDA0192B 
IDA0192F 
IDA0192A 





Operation Being Performed When 
Error Was Detected 


Initialize for catalog interface processing. 


Determine which data sets are associated with data-set 
name on DD statement, determine catalog, and check 
password. 


Determine data-set attributes. 

Get volume information. 

Update “open” indicator in catalog. 

Update catalog when data set is being closed. 
Retrieve volume timestamp. 
Record-Management catalog update. 

Update preformat indicator in catalog. 
Retrieve 44-byte cluster name. 

Retrieve 44-byte component name. 

Initialize for mounting and verify volume. 
Check volume timestamp. 

Handle messages. 

Mount volume. 

Initialize for SMF processing. 

Build SMF record. 

Initialize for staging. 

Build UCB list. 

Build list for ACQUIRE/RELINQUISH (stage/destage). 
Issue ACQUIRE or RELINQUISH. 
Initialize for building control blocks. 
Determine number of buffers needed. 

Build buffers. 

Build control blocks. 

Build string blocks. 

Module initialization. 

Locate data-set attributes and check them for validity. 
Volume processing. 

Preformat extent. 

Initialize for building channel program. 
Build channel program area. 

Check return codes from IFG0191X or IFGO191Y. 
Initialize for VSAM Open processing. 

Verify ACB. 

Fix control blocks in real storage. 

Allow subtasks to share data set. 

Mount and verify volumes. 


Determine whether to connect base cluster to an existing 
structure or generate a new structure. 


\ 
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Code 


88 
89 


93 
95 
96 
99 


100 
101 
103 
104 
105 
106 


107 
108 
110 
111 
112 
113 
114 
115 
148 
149 
150 
151 
153 
154 
155 
156 
157 
158 
159 
160 
161 
End of Volume 
200 
201 
202 
203 


Module that 
Detected 
Error 


IDA0192F 
IDA0192F 
IDA0192F 
IDA0192A 
IDA0192A 
IDA0192A 
IFG0192B 


IFG0200V 
IDA0200T 
IDA0200T 
IDA0200T 
IDA0200T 
IDA0200T 


IDA0200T 
IDA0200T 
IDA0200B 
IDA0200B 
IDA0200B 
IDA0200B 
IDA0200B 
IDA0200B 
IDA0200T 


IDAOCEA2 


IGC0002C 
IDA0231T 
IDA0231T 
IDA0231T 
IDA0231T 
IDA0231T 
IDA0231B 
IDA0231B 
IDA0231B 
IDA0231B 
IDA0231B 


IFG0551F 

IDA0557A 
IDA0557A 
IDA0557A 
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Operation Being Performed When 
Error Was Detected 


Open base cluster. 

Open alternate index in upgrade set. 

Open alternate index in path. 

Build a dummy DEB. 

Terminate VSAM Open processing. 

Clean up after an error in Open processing. 


Error processing for ACB being processed on a system not 
generated for VSAM. 


Read JFCB. 

Initialize for VSAM Close processing. 
Complete deferred write requests. 
Close path. 

Close base cluster. 


Close sphere (close upgrade alternate indexes and free 
storage). 


Close upgrade set. 

Process volume mount table. 

Module initialization. 

Check validity of AMBLs and DEBs. 

SMF processing. 

Update statistics and RBA information in the catalog. 
Free storage for control blocks. 

Write a buffer. 

Force deletion of VSAM global resource pool. 
Force deletion of VSAM global resource pool. 
Read JFCB. 

Initialize for VSAM Close (TYPE=T) processing. 
Complete deferred write requests. 

Close (TYPE=T) path. 

Close (TYPE=T) base cluster. 

Close (TYPE=T) upgrade set. 

Module initialization. 

Check validity of AMBLs and DEBs. 

Update statistics and RBA information. 

SMF processing. 

Write a buffer. 


Read JFCB. 
Initialize for VSAM End-of-Volume processing. 
Locate and mount volume. 


Allocate space. 








Macros 


Mapping Macros 


Function 
Code 


204 
205 
206 
207 
208 
209 


Module that 
Detected 
Error 


IDA0557A 
IDA0557A 
IDA0557A 
IDA0557A 
IDA0557A 
IDA0557A 


Operation Being Performed When 
Error Was Detected 


Switch volumes. 

Build control blocks. 

Update SMF record. 

Preformat extent. 

Record Management, catalog update. 


Reset control blocks. 


The following tables list VSAM and OS/VS macros and explain what they 
do. The macros are divided into those that define control blocks and data 
areas (mapping macros) and those that issue executable code (action macros). 


OS/VS2 VSAM Cross Reference (microfiche) has a table (‘“Macro Where 
Used Report’’) of all the macros issued by VSAM with a listing of the 
modules (and other macros) that issue them. 


The following table lists macros that define the format of control blocks and 
data areas used by VSAM modules. 


Macros That Define Data Areas 

Macro Description 

ACB Builds an access-method control block (ACB) at assembly time 
CVT Maps the communication vector table (CVT) 

ECB Maps the event control block 

IDAAIR Maps the alternate-index record 

IDAAMB Maps the access method block (AMB) 

IDAAMBL Maps the access method block list (AMBL) 

IDAAMBXN Maps the access method block extension (AMBXN) 
IDAAMDSB Maps the access method data set statistics control block (AMDSB) 
IDAARDB Maps the address range definition block (ARDB) 

IDAARWA Maps a recovery work area for the Restart modules 

IDABIB Maps the base information block (BIB) 

IDABFR Maps the buffer control set 

IDABLPRM Maps the resource pool parameter list (BLPRM) 

IDABSPH Maps the buffer subpool header (BSPH) for shared resources 
IDABUFC Maps the buffer control block (BUFC) 

IDACBTAB Maps the tables used by the Control Block Manipulation routine 
IDACIDF Maps the control-interval descriptor field (CIDF) 
IDACLWRK Maps the close work area 

IDACMB Maps the cluster management block (CMB) 

IDACPA Maps the channel program area (CPA) 

IDACSL Maps the core save list (CSL) 
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Macros That Define Data Areas (continued) 


Macro 


IDACTREC 


IDADIWA 
IDADSECT 
IDADSL 
IDAEDB 
IDAELEM 


IDAEQUS 


IDAERMSG 
IDAERRCD 
IDAESL 

IDAFOREC 


IDAGENC 
IDAHEB 
IDAICWA 
IDAIDXCB 
IDAIICB 
IDAIREG 


IDAIMWA 
IDAIOB 
IDAIOMB 
IDAIOSCN 


IDAIRD 
IDAIXSPL 
IDALPMB 
IDAMODC 


IDAOPWRK 


IDAPDPRM 


IDAPLH 
IDAPSL 
IDARDF 
IDAREGS 


IDARMRCD 


IDARPLE 


IDARTMAC 


IDASHOW 


Description 


Maps the work area built when the VS2 Catalog-Management routines 
use Open, Close, or End of Volume 


Maps the data insert work area (DIWA) 

Maps miscellaneous data areas for Checkpoint/Restart 
Maps the DEB save list (DSL) 

Maps the extent definition block (EDB) 


Maps the Control Block Manipulation routine’s element argument 
control entry 


Defines the equates for the ISAM Interface: SY NAD—Message-Build 
routine 


Maps the ISAM Interface: SYNAD Message format 
Lists the VSAM Open and Close ACB Error Codes 
Maps the enqueue save list (ESL) 


Maps the work area for VSAM Open, Close, and End of Volume (the 
work area is called ‘““FORCORE” in program comments) 


IDAFOREC issues IDAPDPRM, IEFJFCBN, and IEFJFCBX. 
Maps the GENCB header argument control entry 

Maps the header element block (HEB) 

Maps the index create work area (ICWA) 

Lists the VSAM control-block-identifier codes 

Maps the ISAM-Interface control block (IICB) 

Defines the ISAM-Interface register usage 


IDAIIREG issues IDAIICB, IDARPLE, IFGRPL, IHADCB, and 
IHADCBDF. 


Maps the index modification work area (IMWA) 
Maps the VSAM IOB extension 
Maps the I/O-Management control block (IOMB) 


Maps the VSAM Open, Close, and End-of-Volume commonly-used 
declarations 


Defines the index record 

Maps the index search parameter list (IXSPL) 

Maps the logical-to-physical mapping block (LPMB) 
Maps the MODCB header argument control entry 
Maps the ACB work area for Open (OPW or OPWRK) 


Maps the VSAM Open, Close, and End-of-Volume problem 
determination parameter list 


Maps the placeholder (PLH) 

Maps the page save list (PSL) 

Maps the record definition field (RDF) 

Defines register usage for all Record-Management modules 

Lists the Record-Management return codes 

Maps the ISAM-Interface request parameter list extension (RPLE) 
Maps data structures for recovery routines 


Maps the SHOWCEB header argument control entry 


374 OS/VS2 Virtual Storage Access Method (VSAM) Logic 


J 


Macros That Define Data Areas (continued) 


Macro 


IDASSL 
IDATEST 
IDAUPT 
IDAVAT 
IDAVCRT 


IDAVGTT 
IDAVIOT 
IDAVMT 
IDAVSRT 
IDAVUCBL 


IDAVVOLL 


IDAWAX 
IDAWSHD 
IECDIOCM 
IECDIOSB 
IECDIPIB 
IECDSECS 
IECDSECT 
IECRRPL 
IECSDSL1 
IEESMCA 
IEEVCHWA 
IEEVRSWA 
IEFJFCBN 
IEFJFCBX 
IEFJMR 
IEFTCT 
IEFTIOT1 
IEFUCBOB 
IEZABP 


IEZCTGFL 
IEZCTGPL 
IEZDEB 
IEZIOB 
IEZJSCB 
IFGACB 
IFGEXLST 
IFGRPL 
IGGCAXWA 


Description 


Maps the swap save list (SSL) 

Maps the TESTCB header argument control entry 

Maps the upgrade table (UPT) for upgrading alternate indexes 
Maps the valid-AMBL table (VAT) 


Maps the VSAM checkpoint/restart table (VCRT), the VSAM 
checkpoint/restart storage blocks (VCRCORE), and the HEB save area 
(VCRHEBSA). 


Maps the VSAM global termination table (VGTT) 
Maps the valid-IOMB table (VIOT) 

Maps the volume mount table (VMT) 

Maps the VSAM shared resource table (VSRT) 


Maps the VSAM Open and End of Volume: Volume Mount and Verify 
UCB list 


Maps the VSAM Open and End of Volume: Volume Mount and Verify 
volume serial number list 


Maps the work area for path processing (WAX) 

Maps the working storage header (WSHD) 

Maps the communication area of the VS2 I/O Supervisor 
Maps the I/O-Supervisor control block (IOSB) 

Maps the I/O Supervisor—Purge interface block (IPIB) 

Maps the DSECS 

Maps the common open/close work area 

Maps the common O/C/EOV Recovery Routine parameter list 
Maps the SDSL1 

Maps the SMCA 

Maps a work area that VS2 Checkpoint passes to VSAM Checkpoint 
Maps a work area that VS2 Restart passes to VSAM Restart 
Maps the job file control block (JFCB) 

Maps the job file control block (JFCB) 

Maps the JMR 

Maps the TCT 

Maps the task input/output table (TIOT) 

Maps the VS2 unit control block (UCB) 


Maps the ABP—I/O-Management communication vector table 
(module IDA1I21CV) 


Maps the VS2 catalog field parameter list (CTGFL) 
Maps the VS2 catalog parameter list (CTGPL) 

Maps the VS2 data extent block (DEB) 

Maps the VS2 input/output block (IOB) 

Maps the VS2 job step control block (JSCB) 

Maps the access-method control block (ACB) 

Maps the exit list (EXLST) 

Maps the request parameter list (RPL) 

Maps the VS2 catalog auxiliary work area (CAXWA) 
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Macros That Define Data Areas (continued) 


Macro 


IHAASCB 
IHAASXB 
IHADCB 
IHADCBDF 
IHADECB 
IHADSAB 
IHAFRRS 


IHAIQE 
IHAPSA 
IHAPVT 
IHARB 
IHARMPL 


IHASDWA 


IHASRB 


IHJSSCR 
IKJRB 
IKJTCB 
XCTLTABL 


Description 

Maps the VS2 address space control block (ASCB) 

Maps the VS2 address space extension control block (ASXB) 
Maps the VS2 data set control block (DCB) 

Maps the VS2 data set control block (DCB) 

Maps the VS2 data extent control block (DECB) 

Maps the VS2 data set association block (DSAB) 


Maps VS2 Recovery Termination Manager Dsects for function 
recovery routines 


Maps the VS2 interrupt queue element (IQE) 
Maps the VS2 prefixed save area (PSA) 
Maps the VS2 page vector table (PVT) 

Maps the VS2 request block (RB) 


Maps the VS2 Resource Manager's parameter list for interfacing with 
VSAM Task Close Executor (IDAOQCEA2) 


Maps the STAE diagnostic work area (SDWA, also called the recovery 
termination communication area—RTCA) 


Maps the VS2 service request block (SRB) 


Maps the subsystem control record of areas saved at checkpoint time 
Maps request blocks 

Maps the task control block (TCB) 

Maps the VS2 XCTL table 


This table lists the macros issued by VSAM that generate executable code. 


Macros That Generate Executable Code 


Macro 
ABEND 
BLDVRP 
CATLG 


CLOSE 
DEBCHK 
DELETE 
DEQ 
DLVRP 
DOM 
ENDREQ 
ENQ 
ERASE 
ESTAE 
EXCP 
FREEMAIN 
GENCB 


Description 
Abnormal termination (VS2 macro) 
Builds a VSAM resource pool for shared resources 


Loads the address of the catalog parameter list (CTGPL) into register 1 
and issues SVC 26 


VSAM CLOSE: Disconnects a user from a VSAM data set 
Checks the validity of the DEB 

(Same as VS2 DELETE macro) 

(Same as VS2 DEQ macro) 

Deletes a VSAM resource pool for shared resources 
Deletes operator message (VS2 DOM macro) 

Terminates a VSAM record processing request (such as GET or PUT) 
(Same as VS2 ENQ macro) 

Deletes a VSAM record 

Specifies task asynchronous exit (VS2 macro) 

(Same as VS2 EXCP macro) 

Releases virtual storage obtained by a GETMAIN 
Generates a VSAM control block (ACB, EXLST, or RPL) 
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Macros That Generate Executable Code (continued) 


Macro 


GET 
GETIX 
GETMAIN 
GTRACE 


IDACALL 


IDACBI1 


IDACB2 


IDAERMAC 


IDAEXITR 


IDAGMAIN 
IDAPATCH 
IDAPFMT 
IDARST14 
IDASVR14 
IECRES 
LOAD 
MODCB 
MODESET 
MRKBFR 
OBTAIN 
OPEN 
PGFIX 


PGFREE 
POINT 
POST 
PUT 
PUTIX 
RESERVE 
RETURN 
SCHBFR 
SDUMP 
SETFRR 
SETLOCK 
SETRP 
SHOWCAT 


Description 

Retrieves a record from a data set on a direct-access device 

Retrieves a control interval from the index of a key-sequenced data set 
Obtains virtual storage for a temporary work area 


Calls the Generalized Trace Facility (GTF) to copy VSAM control 
blocks 


Transfers control from procedure A to procedure B and allows 
procedure B to return control to procedure A at the instruction 
following the IDACALL instruction-expansion 


Transforms operands for Control Block Manipulation macros 
(GENCB, MODCB, SHOWCB, and TESTCB) 


Scans keywords and generates code for Control Block Manipulation 
macros 


Prints MNOTESs for Control Block Manipulation macro 
user-programmer errors 


Transfers control from VSAM modules to a user’s exit routine and 
allows the user exit routine to return control to the VSAM module at 
the instruction following the IDAEXITR instruction-expansion 


IDAEXITR issues DELETE, IDARST14, IDASVR14, and LOAD. 
Gets virtual storage for VSAM Open, Close, and End of Volume 
Generates maintenance space 

Gives control to End of Volume to preformat a control area 
Puts the return address in register 14 

Saves register 14 in the placeholder (PLH) push-down list 
Transfers control to the VS2Resident routine 

(Same as VS2 LOAD macro) 

Modifies a VSAM control block (ACB, EXLST, or RPL) 

(Same as VS2 MODESET macro) 

Marks a buffer in a VSAM resource pool 

(Same as VS2 OBTAIN macro) 

Connects a user's program to a VSAM data set 


‘*Fixes” a page of virtual storage so that it remains in real storage for a 
duration 


‘“Frees” a “‘fixed” page of virtual storage. 

Identifies a starting point in a VSAM data set 

(Same as VS2 POST macro) 

Writes a record into a VSAM data set 

Writes a control interval in the index of a key-sequenced data set 
(Same as VS2 RESERVE macro) 

(Same as VS 2 RETURN macro) 

Searches for a control interval in a VSAM resource pool 
Schedules SVC dump routine (VS2 macro) 

Sets up functional recovery routine (VS2 macro) 
Obtains or releases a lock (VS2 macro) 

Records recovery information (VS2 macro) 


Displays information from a VSAM catalog 
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Macros That Generate Executable Code (continued) 


Macro 


SHOWCB 


SMFWTM 
STARTIO 
SYNCH 
TESTAUTH 
TESTCB 
TIME 
VERIFY 


WAIT 
WRTBFR 
WTO 
XCTL 


Description 


Displays information from a VSAM control block (ACB, EXLST, 
or RPL) 


Writes the SMF message into the SMF data set 

Gives control to the VS2 I/O Supervisor to start an I/O operation 
(Same as ISAM SYNCH macro) 

Checks authorization of a calling module to perform certain functions 
Tests information in a VSAM control block (ACB, EXLST, or RPL) 
Obtains the correct time from the VS2 system time-of-day clock 


Gives control to Record Management to check the end-of-data 
indicators for Checkpoint/Restart or for Access Method Services 
VERIFY command 


(Same as VS2 WAIT macro) 
Writes buffers from a VSAM resource pool 
Writes a message to the operator (no reply) 


Transfers control (VS2 XCTL macro) 


Note: The use of these user macros is described in OS/VS Virtual Storage 
Access Method (VSAM) Programmer’s Guide: 


CLOSE 


ENDREQ 


ERASE 
GENCB 
GET 
MODCB 
OPEN 
POINT 
PUT 


SHOWCB 


TESTCB 


The use of these user macros is described in OS/VS Virtual Storage Access 
Method (VSAM) Options for Advanced Applications: 


BLDVRP 
DLVRP 
GETIX 


MRKBFR 


PUTIX 
SCHBFR 


SHOWCAT 
WRTBFR 
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Generalized Trace Facility 


Return Codes 


The Generalized Trace Facility (GTF) can be used to record information 
about VSAM processing at the time of an error. If GTF is active in the VS2 
system, GTF is used to trace VSAM control blocks when there is an error. 


GTF is used to record the contents of the ACB, AMBL, AMBs, AMDSBs, 
and TIOT entry for the data set being processed when the error occurred. 


To format and print GTF records, use the IMDPRDMP service aid with 
‘USR=(FFF,FF5)’ specified in the EDIT statement. 


Two types of traces are available to help in debugging VSAM 
Open/Close/End-of-Volume problems: 


e The error trace routine traces VSAM control blocks when an error is 
detected. The optional work area trace traces the 
Open/Close/End-of-Volume work area WTG table prefix and the current 
entry in the WTG table at entry to and exit from the VSAM 
Open/Close/End-of-Volume modules. 


e The work area trace is requested by specifying AMP=‘TRACP’. This is 
the same trace that is obtained for nonVSAM 
Open/Close/End-of-Volume processing when DCB=DIAGNS=TRACE 
is specified in the JCL. (For details on the AMP and DCB JCL parameters 
and options, see OS/VS2 JCL. 


Both traces require that GTF be operating in external mode while the job to 
be traced is running. In addition, the operator must respond with 
“TRACE=USR”’ when the GTF trace message“SPECIFY TRACE 
OPTIONS” appears at the operator’s console. 


Additional information on GTF and IMDPRDM*P is contained in the 
OS/VS2 System Programming Library: Service Aids. 


VSAM sets return codes in the RPL and the ACB. These codes are paired 
with codes in register 15. Codes set in the RPL are listed and explained under 
“Return Codes from the Record-Management (Request) Macros.”’ Those set 
in the ACB, which indicate open or close errors, are listed and explained 
under ‘“‘Open and Close Return Codes.”’ 


VSAM sets a pair of codes in registers 15 and 0 for the control block 
manipulation macros. These are listed and explained under “Control Block 
Manipulation Return Codes.” 


Return Codes from the Record-Management (Request) Macros 


After a request macro or a CHECK or ENDREQ macro is issued, register 15 
contains a return code. 


After an asynchronous request for access to a data set, VSAM indicates in 
register 15 whether the request was accepted, as follows: 

Reg 15 Condition 

0(0) Request was accepted. 


4(4) Request was not accepted because the request parameter list indicated by the 
request (RPL=address) was active for another request. 
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After a synchronous request, or a CHECK or ENDREQ macro, register 15 
indicates whether the request was completed successfully, as follows: 


Reg 15 Condition 
0(0) Request completed successfully. 


4(4) Request was not accepted because the request parameter list indicated by the 
request (RPL=address) was active for another request. 


8(8) Logical error; specific error is indicated in the feedback field in the RPL. 
12(C) Physical error; specific error is indicated in the feedback field in the RPL. 


Paired with the 0, 8, and 12 indicators in register 15 are return codes in the 
feedback field of the request parameter list. 


The feedback return codes for the 0 indicator in register 15, which doesn’t 
cause VSAM to exit to an exit routine, are: 


RPLFDBK 
Code Condition 


0(0) Request completed successfully. 


4(4) Request completed successfully. For retrieval, VSAM mounted another volume 
to locate the record; for storage, VSAM allocated additional space or mounted 
another volume. 


8(8) Duplicate alternate key follows. 
12(C) (Shared resources only.) A buffer needs to be written. 


See the discussions below for the logical-error return codes and for the 
physical-error return codes. 


Function Codes for Logical and Physical Errors 


Logical-Error Return Codes 


When a logical or physical error occurs during processing that involves 
alternate indexes, VSAM provides a code in the RPLCMPON field that 
indicates whether the base cluster, its alternate index, or its upgrade set was 
being processed and whether upgrading was okay or might have been 
incorrect because of the error: 


Code What Was Being Processed Status of Upgrading 
0(0) Base cluster Okay 

1(1) Base cluster Might be incorrect 
2(2) Alternate index Okay 

3(3) Alternate index Might be incorrect 
4(4) Upgrade set Okay 

5(5) Upgrade set Might be incorrect 


When a logical-error-analysis exit routine (LERAD) is provided, it gets 
control for logical errors, and register 15 doesn’t contain 8, but contains the 
entry address of the LERAD routine. 


Figure 57 gives the contents of the registers when VSAM exits to the LERAD 
routine. 


If a logical error occurs and a LERAD exit routine isn’t provided (or the 
LERAD exit is inactive), VSAM returns control to the processing program 
following the last executed instruction. Register 15 indicates a logical error 
(8), and the feedback field in the request parameter list contains a code 
identifying the error. Register 1 points to the request parameter list. 
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Reg 


2-13 


14 
15 


Contents 
Unpredictable. 


Address of the request parameter list that contains the feedback field the routine 
should examine. The register must contain this address if the exit routine returns 
to VSAM. 


Same as when the request macro was issued. Register 13, by convention, contains 
the address of the processing program’s 72-byte save area, which may not be used 
as a save area by the LERAD routine if the routine returns control to VSAM. 


Return address to VSAM. 


Entry address to the LERAD routine. The register doesn’t contain the 
logical-error indicator. 


Figure 57. Contents of Registers When a LERAD Routine Gets Control 


Figure 58 gives the logical-error return codes in the feedback field and 
explains what each one means. 
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RPLFDBK 


Code 
4(4) 


8(8) 


12(C) 


16(10) 


20(14) 


24(18) 


28(1C) 


32(20) 


36(24) 


40(28) 


44(2C) 


64(40) 


68(44) 


72(48) 


Condition 


End of data set encountered (during sequential retrieval). Either no EODAD 
routine is provided, or one is provided and it returned to VSAM and the 
processing program issued another GET. 


Detected by: IDA019RA, IDAO19RD, IDAOI9RR, IDAODISRY 
IDA019R2, IDA019R4, IDA019R8 


Attempt was made to store a record with a duplicate key. 
Detected by: IDA019RA, IDA019RQ, IDA019RX, IDA019R4 


Attempt was made to store a record out of ascending key sequence; record may 
also have a duplicate key. 


Detected by: IDA0O19RA, IDA0I9RR, IDA019RX, IDA019R4 
Record not found. 

Detected by: IDA019RA, IDA019RR, IDAOIORY 

Record already held in exclusive control by another requester. 
Detected by: IDA019RF, IDAOI9RY, IDA019R2, IDAO19R8 
Record resides on a volume that can’t be mounted. 

Detected by: IDA019RW, IDAOI9RY, IDA019R2, IDA019R5 


Data set cannot be extended because VSAM can’t allocate additional 
direct-access storage space. Either there isn’t enough space left in the data space 
for the secondary-allocation request or an attempt was made to increase the size 
of a data set during processing with SHROPT=4 and DISP=SHR. 


Detected by: IDA019R5 


An RBA was specified that doesn’t give the address of any data record in the data 
set. 


Detected by: IDA0N19RA, IDA019R8 


Key ranges were specified for the data set when it was defined, but no range was 
specified that includes the record to be inserted. 


Detected by: IDA019RM 

Insufficient virtual storage in the address space to complete the request. 
Detected by: IDA019RG, IDAO19RU, IDA0I9RX 

Work area not large enough for the data record (GET with OPTCD=MVE). 


Detected by: IDA019RR, IDAO19RT, IDAOI9RY, 
IDA019R4, IDA019R8 


As many requests are active as the number specified in the STRNO parameter of 
the ACB macro; therefore, another request cannot be activated. 


Detected by: IDA019RU, IDA019RX, IDA019R1 


Attempt was made to use a type of processing (output or control-interval 
processing) that was not specified when the data set was opened. 


Detected by: IDA019RQ, IDA019R4, IDA019R8 


A keyed request for access was made to an entry-sequenced data set or a GETIX 
or PUTIX was issued to an entry-sequenced or relative record data set. 


Detected by: IDA019R1, IDA019R8 


Figure 58 (Part 1 of 3). Logical-Error Return Codes in the RPL Feedback Field 





from a Request Macro 


382 OS/VS2 Virtual Storage Access Method (VSAM) Logic 


J 





RPLFDBK 


Code 
76(4C) 


80(50) 


84(54) 


88(58) 


92(5C) 


96(60) 


100(64) 


104(68) 


108(6C) 


Condition 


An addressed or control-interval PUT was issued to add a record toa 
key-sequenced data set, or a control-interval PUT was issued to a relative record 
data set. 


Detected by: IDA019R1, IDA019R8 
An ERASE request was issued for access to an entry-sequenced data set. 
Detected by: IDA019RL, IDA019RX, IDAO19R8 


OPTCD=LOC was specified for a PUT request or in a request parameter list in a 
chain of request parameter lists. 


Detected by: IDA019RQ, IDA019R1, IDA019R4, IDAO19R8 


A sequential GET or PUT request was issued without VSAM having been 
positioned for it, or a change was made from addressed access to keyed access 
without VSAM having been positioned for keyed sequential retrieval, or an 
illegal switch between forward and backward processing was attempted. 


Detected by: IDA019RQ, IDAOI9RR, IDA019R4, IDA019R8 


A PUT for update or an ERASE was issued without a previous GET for update, 
or a PUTIX was issued without a previous GETIX. 


Detected by: IDA019RQ, IDAO1I9ORX, IDA019R4, IDA019R8 

Attempt was made to change a key during an update. 

Detected by: IDA019RL, IDAO19RX 

Attempt was made to change the length of a record during an addressed update. 
Detected by: IDAO19RL, IDA019RQ 

The RPL options are either invalid or conflicting in one of the following ways: 

° SKP was specified and either KEY wasn’t specified or BWD was specified 
° BWD was specified for CNV processing 

° FWD and LRD were specified 

° Neither ADR, CNV, nor KEY was specified in the RPL 


° WRTBFR, MRKBFR, or SCHBFR was issued, but either TRANSID was 
greater than 31 or a shared-resources option wasn’t specified 


° ICI processing was specified, but a request other than a GET or a PUT 
was issued 


Detected by: IDA019RA, IDAOI9RR, IDAO19RY, IDAO19RX, 
IDA019R1, IDA019R4, IDA0198 


RECLEN specified was larger than the maximum allowed, equal to 0, smaller 
than the sum of the length and the displacement of the key field, or not equal to 
record (slot) length specified for a relative record data set. 


Detected by: IDA019RL, IDA019RQ, IDA019RU, 
IDA019R4, IDA019R8 


Figure 58 (Part 2 of 3). Logical-Error Return Codes in the RPL Feedback Field 


from a Request Macro 
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RPLFDBK 


Code 
112(70) 


116(74) 


132(84) 


136(88) 


140(8C) 


144(90) 


148(94) 


152(98) 


192(CO) 


196(C4) 


200(C8) 


204(CC) 


Condition 
KEYLEN specified was too large or equal to 0. 
Detected by: IDA019R1 


A GET, POINT, ERASE, direct PUT, skip sequential PUT, or PUT with 
OPTCD=UPD not permitted during initial data-set loading (that is, for storing 
records in the data set the first time it’s opened). 


Detected by: IDA019RR, IDA019R4, IDA019R8 

An attempt was made in locate mode to retrieve a spanned record. 

Detected by: IDA019RT 

An addressed GET was issued for a sennned record in a key-sequenced data set. 
Detected by: IDA019RT 

Inconsistent spanned-record segments. 

Detected by: IDA019R4 

Invalid pointer in an alternate index (no associated base record). 

Detected by: IDAON19RX 

The maximum number of pointers in the alternate index has been exceeded. 
Detected by: IDA019RU 

(Shared resources only.) Not enough buffers are available to process the request. 
Detected by: IDAOI9RY 

Invalid relative record number. 

Detected by: IDA01I9RQ, IDA019RR 

An addressed request was issued to a relative record data set. 

Detected by: IDAO19R1 

Addressed or control-interval access was attempted by way of a path. 

Detected by: IDA019RX 

PUT-insert requests are not allowed in backward mode. 


Detected by: IDA019RQ, IDA019R4 


Figure 58 (Part 3 of 3). Logical-Error Return Codes in the RPL Feedback Field 





from a Request Macro 
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Physical-Error Return Codes 


When a physical-error-analysis exit routine (SYNAD) is provided, it gets 
control for physical errors, and register 15 doesn’t contain 12, but contains 
the entry address of the SYNAD routine. 


Figure 59 gives the contents of the registers when VSAM exits to the SYNAD 
routine. 


Reg Contents 
0 Unpredictable. 
1 Address of the request parameter list that contains a feedback return code and 


the address of a message area, if any. If a request macro was issued, the RPL is 
the one pointed to by the request macro; if a CLOSE macro was issued,the RPL 
was built by VSAM to process the close request. Register 1 must contain this 
address if the exit routine returns to VSAM. 


2-13 Same as when the request macro or CLOSE macro was issued. Register 13, by 
convention, contains the address of the processing program’s 72-byte save area, 
which may not be used by the SYNAD routine if it returns control to VSAM. 


14 Return address to VSAM. 


15 Entry address to the SYNAD routine. The register doesn’t contain the 
physical-error indicator. 


Figure 59. Contents of Registers When a SYNAD Routine Gets Control 


If a physical error occurs and a SYNAD exit routine isn’t provided (or the 
SYNAD exit is inactive), VSAM returns control to the processing program 
following the last executable instruction. Register 15 indicates a physical error 
(12), and the feedback field in the request parameter list contains a code 
identifying the error. Register 1 points to the request parameter list. 


Figure 60 gives the physical-error return codes in the feedback field and 
explains what each one indicates. If the user provided a message area, it 
contains a physical-error message with more details about the error. 


RPLFDBK 

Code Condition 

4(4) Read error occurred for a data component. 

8(8) Read error occurred for the index set of an index component. 


12(C) Read error occurred for the sequence set of an index component. 
16(10) Write error occurred for a data component. 

20(14) Write error occurred for the index set of an index component. 
24(18) Write error occurred for the sequence set of an index component. 


All physical errors are detected by IDA019RS from I/O Management 
abnormal-end appendage, IDA121A4. 


Figure 60. Physical-Error Return Codes in the RPL Feedback Field from a Request Macro 
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Figure 61 gives the format of a physical-error message. The format and some 
of the contents of the message are purposely similar to the format and 


contents of the SYNADAF message, which is described in OS/VS Data 
Management Macro Instructions. 


Field Bytes Length Discussion 
Message 0 1 2 Binary value of 128 
Length 
3 2 Unused (0) 

Message 4 5 2 Binary value of 124 
Length - 4 (provided for compatibility with SYNADAF 
message) 

6 7 2 Unused (0) 
Address of 8 11 4 The I/O buffer associated with the data in 
I/O Buffer relation to which the error occurred 
The rest of the message is in printable format: 
Date 12 16 5 YYDDD (year and day) 

17 1 Comma (,) 
Time 18 25 8 HHMMSSTH (hour, minute, second, and tenths 

and hundredths of a second) 

26 1 Comma (,) 

RBA 27 34 8 Relative byte address of the record in relation to 


which the error occurred. 


35 1 Comma (,) 
Data-Set 36 «41 6 “DATA” or “INDEX”’ 
Type 
42 1 Comma (,) 
Volume Serial 43 48 6 Volume serial number of the volume in relation 
Number to which the error occurred 
49 1 Comma (,) 
Job Name 50 57 8 Name of the job in which error occurred 
58 1 Comma (,) 
Step Name 59 66 8 Name of the job step in which error occurred 
67 1 Comma (,) 
Unit 68 70 3 The unit, CUU (channel and unit), in relation to 
which the error occurred 
71 1 Comma (,) 
Device Type 72 73 Z The type of device in relation to which the error 
occurred (always DA for direct access) 
14 1 Comma (,) 
ddname 75 82 8 The ddname of the DD statement defining the 
data set in relation to which the error occurred 
83 1 Comma (,) 
Channel 84 89 6 The channel command that occasioned the error 
Command in the first two bytes, followed by ‘‘-OP” 
90 1 Comma (,) 


Figure 61 (Part 1 of 2). Format of Physical-Error Messages 


386 OS/VS2 Virtual Storage Access Method (VSAM) Logic 


Field Bytes Length 
Message 91 105 15 





Discussion 

Messages are divided according to ECB condition 
codes: 

xX‘41°-— 

“UNIT EXCEPTION” 
‘“*PROGRAM CHECK’”’ 
“PROTECTION CHK’”’ 
“CHAN DATA CHK” 
““CHAN CTRL CHK” 
“INTFCE CTRL CHK” 
““CHAINING CHK’”’ 
“UNIT CHECK” 


If the type of unit check can be determined, this message is replaced by one of the 


following: 

106 1 
Physical 107 120 14 
Direct-Access 
Address 

121 1 


Access Method 122 127 6 


“CMD REJECT” 

“INT REQ” 

“BUS OUT CK” 

“EQP CHECK” 
“DATA CHECK” 
“OVER RUN” 
“TRACK COND CK” 
“SEEK CHECK” 
“COUNT DATA CHK” 
“TRACK OVERRUN” 
“CYLINDER END” 
“INVALID SEQ” 

“NO RECORD FOUND” 
“FILE PROTECT” 
“MISSING A.M.” 
“OVERFL INCP” 


X‘48’—"*PURGED REQUEST” 
X‘4F’—“R.HA.RO. ERROR” 


For any other ECB completion 
code—*UNKNOWN COND.” 


Comma (,) 


BBCCHHR (bin, cylinder, head, 
and record) 


Comma (,) 


“VSAM” 


Figure 61 (Part 2 of 2). Format of Physical-Error Messages 


Open and Close Return Codes 


When a processing program receives control after it has issued an OPEN or 
CLOSE macro, register 15 indicates whether all of the data sets were opened 


or closed successfully: 


Reg 15 Condition 


0(0) All data sets were opened or closed successfully. 


4(4) Open: all data sets were opened successfully, but one or more warning messages 
were issued (ACBERFLG codes less than X‘80’). 
Close: at least one data set (VSAM or nonVSAM) was not closed successfully. 


8(8) Open: at least one data set (VSAM or nonVSAM) was not opened successfully; if 
there was an error for an ACB, it was restored to the contents it had before 


OPEN was issued. 


12(C) Open: at least one data set (VSAM or nonVSAM) was not opened successfully; if 
there was an error for an ACB, it was not restored to the contents it had before 
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OPEN was issued (and the data set cannot be opened without the ACB’s being 
restored). 


ACBERFLG Code Condition 


0(0) 


4(4) 


96 (60) 


100 (64) 


104 (68) 


108 (6C) 


116 (74) 


128 (80) 
132 (84) 


136 (88) 


144 (90) 


148 (94) 


152 (98) 


160 (AO) 
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When register 15 contains 0: 
All data sets were opened or closed successfully 


When register 15 contains 8: 
Either VSAM is processing the ACB for some other request, 


Or DDNAME was not specified in the ACB 


Warning message: the ACB is already opened (and the user issued 
OPEN), or the ACB is already closed (and the user issued CLOSE 
or temporary CLOSE). 


Warning message: an unusable data set was opened for input. 
Detected by: IDA0192B 


Warning message: Open encountered an empty alternate index 
that is part of an upgrade set. 


Detected by: IDA0192B 


Warning message: the timestamp for the volume does not match 
the timestamp in the catalog record for the data set. (This may 
mean the cluster existing on the volume(s) is not accurately 
described by its catalog record.) 


Detected by: IDA0192A 


Warning message: the timestamp for the index is less than the 
timestamp for the data set. (This could occur if the data set was 
updated without the index being open.) 


Detected by: IDA0192B 


Warning message: the last request to close this data set was not 
completed successfully. 


Detected by: IDA0192B 

DDNAME not found in TIOT. 

An I/O error was detected while the system was reading the JFCB. 
Detected by: IDA0192F, IDA0200V 


Not enough storage was available for work areas, buffers, or 
control blocks. 


Detected by: IDA0192A, IDA0192B, IDA0192C, IDA0192F, 
IDA0192W, IDA0192Y, IDA0192Z, IDA0200B, 
IDA0200T, IDA0231B, IDA0231T 


An I/O error occurred while a catalog record was being read or 
written. A return code was set by a VS2 Catalog-Management 
routine. 


Detected by: IDA0192C 


The catalog entry for the data set being opened or closed was not 
found or an unidentified error occurred while VSAM was 
searching the catalog. 


Detected by: IDA0192C 


The data set being opened is protected by a password, and the 
VSAM Open routine was unable to validate the password. 


Detected by: IDA0192C 


The buffer space specified was not consistent with the buffer 
requirements of the data set; or the ACB indicated keyed access, 
but the data set is not a key-sequenced data set; or the device type 
specified in the DD statement is not consistent with the device type 
indicated in the catalog entry for the data set; or user buffering is 
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ACBERFLG Code 


164 (A4) 


168 (A8) 


176 (BO) 


180 (B4) 


184 (B8) 


188(BC) 


192 (CO) 


196 (C4) 


200 (C8) 


204 (CC) 


212 (D4) 


216 (D8) 


220 (DC) 


224 (EO) 


228 (E4) 


Condition 


specified in the ACB’s MACRF field and control-interval 
processing should be specified, but is not. 


Detected by: IDA0192A, IDA0192B, IDA0192C, IDA0192Z 


The system detected an I/O error while reading the volume label 
and format-4 DSCB. 


Detected by: IDA0192F 


The Open routine was unable to get the resource the system 
requested for the data set being opened. The resource was being 
used by another task in the system. 


Detected by: IDA0192B 


The Open routine was unable to fix in real storage the 
access-method control blocks for the data set being opened. 


Detected by: IDA0192F 

The requested master or user catalog does not exist or is not open. 
Detected by: IDA0192C 

An I/O error occurred during I/O processing. 


Detected by: IDA0192B, IDA0200B, IDA0200T, 
IDA0231B, IDA0231T 


The data set indicated by the ACB is not the type that may be 
specified by an ACB. 


Detected by: IDA0192Z, IDA0200B, IDA0231B 

An unusable data set was opened for output. 

Detected by: IDA0192B 

Access to data was requested by way of an empty path. 
Detected by: IDA0192B 


The Format-4 DSCB indicates the volume is unusable, so the data 
set cannot be opened. 


Detected by: IDA0192F 


The ACB MACREF specified GSR, but the program that issued 
OPEN isn't in supervisor state with protection key 0 or 7. 


Detected by: IDA0192A 


The ACB MACREF specified GSR or LSR, but the data set requires 
create processing. 


Detected by: IDA0192B 


The ACB MACRE specified GSR or LSR, but the key length of the 
data set exceeds the maximum key length specified in BLDVRP. 


Detected by: IDA0192B 


The ACB MACRE specified GSR or LSR, but the data set’s 
control interval size exceeds the size of the largest buffer specified 
in BLDVRP. 


Detected by: IDA0192Z 


The ACB MACRF specified ICI, but the data set requires create 
processing. 


Detected by: IDA0192B 


The ACB MACREF specified GSR or LSR, but the VSAM shared 
resource table doesn’t exist. 


Detected by: IDA0192A 
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ACBERFLG Code Condition 
232 (E8) Reset was specified for a nonreusable data set, but the data set is 

empty. 

Detected by: IDA0192C wil 
236 (EC) A permanent staging error (ACQUIRE) or destaging error 


(RELINQUISH) occurred in the Mass Storage System. 
Detected by: IDA0192D 


240 (FO) Format-4 DSCB and catalog time-stamp verification failed during 
volume mounting for output processing. 


Detected by: IDA0192F 


244 (F4) The volume that contains the catalog recovery area wasn't 
mounted and verified for output processing. 


Detected by: IDA0192F 


End-of-Volume Return Codes 


These codes are returned by End of Volume to modules that call End of 
Volume. For Open and Close, those that indicate an error result in an 
ACBERELG code’s being returned to the user. 


Reg 15 Condition 
0 (0) Successful. 
4 (4) The requested volume could not be mounted. 
8 (8) The requested amount of space could not be allocated. 
12 (C) I/O operations were in progress when End of Volume 
was requested. 
16 (10) The VS2 catalog could not be updated. J 
All End-of-Volume errors are detected by IDAO557A. | 


Control Block Manipulation Return Codes 


When the Control Block Manipulation routine returns to the caller after 
successful completion, register 15 contains 0. If the request is GENCB, 
register 0 contains the total length of the area that contains the control 
block(s). Register 1 contains the address of the area. 


When the Control Block Manipulation routine returns to the caller with a 
nonzero value in register 15, an error occurred. If the request is TESTCB and 
the caller supplied a ERET keyword, return is to the location specified by the 
ERET keyword. Otherwise, the Control Block Manipulation routine returns 
control to the point of invocation, via the return address in register 14. 


Register 15 contains a return code: 


Reg 15 Condition 

0(0) Successful completion. 

4(4) An error has been detected. The error code in register 0 indicates the type 
of error. 

8(8) Invalid use of the execute form of this macro. Since the return code is set 


by the macro expansion and not by the Control Block Manipulation 
routine, the register 0 contents do not indicate an error code. 
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Register 0 contains an error code: 


Code 
1 (1) 
2 (2) 
3 (3) 
4 (4) 


5 (5) 
6 (6) 


7 (7) 


8 (8) 


9 (9) 
10 (A) 
11 (B) 


12 (C) 
13 (D) 


14 (E) 


15 (F) 
16 (10) 


19 (13) 


20 (14) 


21 (15) 


Applicable 
Macros* 


G,M,S,T 
G,M,S,T 
G,M,S,T 
M,S,T 


S,T 
S,T 


M,S 


G 


G,S 
G,M 


G,M,T 


G,S 
G,M,S,T 


M,S,T 


S,T 


Condition 

The function type is invalid. 

The control-block type is invalid. 
The keyword type is invalid. 


The control block to be processed isn’t of the type 
specified. 


The ACB to be processed is closed—it must be open. 


The cluster whose index component was to be processed 
isn’t key-sequenced (doesn’t include an index). 


The EXLST entry to be processed isn’t present. 


Not enough virtual storage is available, or (with 
AM=VTAM specified) list and execute forms are 
inconsistent. 


User area is too small. 
Exit address isn’t specified in the input. 


The RPL to be processed is active, or it is already being 
processed. 


The ACB to be processed is open—it must be closed. 


No exit address is specified in the input for the exit to be 
activated. 


An invalid combination of option codes (for example, for 
MACRF or OPTCD) is specified. 


The user area isn’t on a fullword boundary. 


A VTAM keyword is specified with AM=VTAM not 
specified. 


A specified keyword refers to a field beyond the end of the 
control block to be processed. 


A specified keyword requires processing with shared 
resources to be specified, but it isn’t. 


The block to be displayed or tested does not exist because 
the data set is a dummy data set. 


*G=GENCB, M=MODCB, S=SHOWCB, T=TESTCB 


All errors in control block manipulation are detected by IDA019C1. 
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Virtual-Storage Management 


The getting and freeing of storage for VSAM control blocks is managed 

centrally by IDA0192M. To allocate storage efficiently, IDA0192M (in most J 
cases) gets storage in blocks large enough to satisfy not only a current request } 

for storage for a control block, but also subsequent requests for storage for 

the same or a related control block. Figure 62 indicates: 


e What control block(s) are stored in each type of storage block 
e What block gives the address of each storage block 


e What subpool each storage block is located in (subpools 234, 241, 245, 
and 252 are protected with key 0; subpool 250 is unprotected—attributes 
of system subpools are described in OS/VS2 Scheduler and Supervisor 
Logic) 


« The size of each storage block (unused space in a block is freed after all 
required control blocks have been allocated) 


e Whether each storage block is fixed in real storage by Open 


To allocate and free storage in a storage block, IDA0192M uses these control 
blocks (which are described in detail in ‘“Data Areas”’): 


e BIB—the base information block is built in subpool 252 upon a request to 
build it from the VSAM Open module IDA0192A. One BIB is built for all 
processing related to a particular base cluster in the job step. 


e CMB—the cluster management block is built in subpool 252 upon the first 
request to open a particular cluster from the VSAM Open module 
IDA0192F. It enables IDA0192M to control the allocation and freeing of 
control blocks for the cluster. It contains the addresses of the header J 
elements in header element blocks (described next) that identify the 
storage blocks that contain control blocks for the cluster. 


After a CMB has been built for a cluster, subsequent requests for storage 
for control blocks for the cluster (related to the same open) are satisfied, if 
possible, by using storage blocks already obtained. As storage blocks fill 
up, IDA0192M gets additional ones. 


e HEB—the header element block is built (in the protected sphere block) by 
IDA0192M to manage the allocation and freeing of unprotected storage 
blocks. A HEB contains 16 header elements, each of which, when used, 
identifies and describes a storage block. The CMB indicates by the position 
of an entry that points to a header element what type of storage block the 
header element describes. The header element gives the block’s address, 
length, subpool number, and available space. It doesn’t give the address 
within the block of individual control blocks. These addresses are given by 
the control blocks within the VSAM control block structure, which is 
described in “Data Areas.” 





392 OS/VS2 Virtual Storage Access Method (VSAM) Logic 





Storage Block 
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Blocks Related to the Job Step as a Whole 


Sphere Block! 


Protected 
Sphere AMBL 
Block! 


Protected 
Sphere Block 
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cluster (path 
processing) and 
the alternate 
indexes in the 
upgrade set, RPLs 
for the alternate 
indexes in the 
upgrade set, UPT 
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Buffer Block3 


Upgrade Buffer 
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EDB Block 


String Block3.6 


Fixed String 
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Fixed Upgrade 
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Figure 62 (Part 1 of 2). Storage Blocks Used for Virtual-Storage Management 


I/O buffers 


I/O buffers 
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path PLHs 


PFLs, IOSBs, 
SRBs, IQEs 


IOMBs, CPA 


BUFCs, PLHs 


PFLs, IOSBs, 
SRBs, IQEs 


Pointed 
to by 


BIB 


BIB 


BIB 


CMB 


CMB 


CMB 


CMB 


CMB 


CMB 


CMB 


CMB 


CMB 


Obtained 
in Subpool 


2502 


2522 


241 


250+ 


250 


2305 
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2502 


245 
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Fixed in Real 
Storage by Open? 


No 


No 
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No 
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No 
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Pointed Obtained Fixed in Real 


Storage Block Contains to by in Subpoo!l Size Storage by Open? 

Blocks Related to a Particular Cluster (continued) , 

Protected IOMBs, CPA CMB 252 2K or No 

Upgrade String larger 

Block! 

User Block AMBXN, AMDSBs, CMB 2502 2K or No4 
ARDBs, BUFC larger 


headers, preformat 
BUFCs, preformat 


CPAs, IWAs 
Protected User LPMBs, AMBs CMB 2522 3 LPMBs, No4 
Block 2 AMBs, 
64 bytes for 
set sector 
table 
Fixed Block3 IRB CMB 254! 1 IRB No 


1 This block doesn’t exist for a catalog or a catalog recovery area built in system storage. 


2 Subpool is 231 for a catalog or a catalog recovery area built in system storage; subpool is 241 for processing with global shared 
resources (GSR). 


3 This block isn’t built by Open for processing with shared resources—it’s built by BLDVRP and resides in the resource pool. 
4 This block is fixed in real storage if requested by the user for improved control-interval processing (fast path). 


5 Subpool is 241 for a catalog, for a catalog recovery area built in system storage, or for processing with global shared resources 
(GSR). 


6 For certain processing, Close acquires this block and frees it after the processing is finished. 
7 Subpool is 245 for a catalog, for a catalog recovery area built in system storage, or for processing with global shared 


resources(GSR). 


Figure 62 (Part 2 of 2). Storage Blocks Used for Virtual-Storage Management 





Figure 63 gives the interrelationship of these control blocks. It shows two 
storage blocks obtained for DEBs. Storage blocks are obtained for other 
control blocks in the same way. A DEB block is just large enough to contain 
the DEB for which storage is requested. Some other storage blocks are large 
enough to contain several control blocks of the same or a related type, for 
which storage might be requested subsequently. 


As a by-product, these control blocks map the location, by storage block, of 
VSAM control blocks for clusters (and associated paths and upgrade sets). 
BIBs, CMBs, and HEBs are in protected storage; they can be used to find a 
control block when a pointer in the VSAM control block structure has been 
destroyed or can’t be found. 


394 OS/VS2 Virtual Storage Access Method (VSAM) Logic 


9 


‘a 


C 


VSAM O/C/EOV 
Work Area 


6 
| te 
yf 


+ CMB Virtual 
Storage 
Subpool Size of Request Management 











rower 
ee 


31st Entry 
32nd Entry 


Protected Sphere Block 


i ee First DEB 
First Header Element ist : 
ie! for which 
Second Header Element Storage was 
¥ ai requested 
Third Header Element 


Fourth Header Element 


ACBs for the base 
cluster (path processing) 
and the alternate indexes 
in the upgrade set 





RPLs for the alternate 
indexes in the upgrade 
set 





24 











28 






UPT 





32 






36 









DEB Storage Block 





8 | t User Block Header 


12 | t Protected User Block Header 





16 | t String Block Header DEB Storage Block 


Second DEB 
for which 


20 | tT Upgrade String Block Header 


16th Header Element 


(‘Dummy’) AMBLs for base 
cluster (path processing) and 
the alternate indexes in the upgrade 
set 





24 | ft Fixed String Block Header 


storage was 
requested 





3 | t Fixed Upgrade 
String Block Header 







32 | tT Buffer Block Header 

36 | t Upgrade Buffer Block Header 
40| t DEB Block Header 

44| t EDB Block Header 


48] +Protected String Block Header 


59 tProtected Upgrade String 
Block Header 


Figure 63. Virtual-Storage Management Control Block Structuree 
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Open, Close, and End-of-Volume Diagnostics 


This section describes information in dumps from Open, Close, and End of ’ 
Volume and how to obtain dumps additional to standard dumps. J 


Data-Set Management Recovery Routine (IDAOCEA 1) 


IDAOCEAL1 gets control from the VS2 ESTAE routine for I/O Support 
Recovery when an error occurs while Open, Close, or End of Volume is 
processing. 


IDAOCEAT|1 records in the field SDWARECP of the STAE diagnostic work 
area (SDWA, also known as the Recovery termination communication 
area—RTCA) the 8-character name of the failing module, its 8-character 
csect name, and the 8-character name of the recovery routine. SDWA is 
dumped into SYS1.LOGREC. The areas and modules identified here are 
dumped into SYS1.DUMP. 


IDAOCEAL uses the two words DXATEXC1 and DXATEXC2? in the 
Open/Close/End-of-Volume work area (referred to in program comments as 
“FORCORE’’). 


The first byte in DXKATEXC1 indicates the function in progress when the 
error occurred: 


X‘80’ IFGO0192A, the interface between VS2 Open/Close/End of Volume and 
VSAM (this high-order bit is on in all cases) 
X*40’ ISAM-Interface Close 
X‘20’ ISAM-Interface Open 
X‘10’ Temporary Close 
X‘08’ End of Volume 
x‘04’ Close 
X‘02’ Open e 
X‘01’ BLDVRP or DLVRP (build or delete VSAM resource pool) 
The second byte in DXATEXC1 is an indicator for checkpoint/restart 


processing: 
Dee + See Checkpoint in progress 
bisa. ak Restart in progress 
salicr pect Checkpoint/restart cleanup processing 
ead bes Recovery routine recursion indicator 
wees XXXX Reserved 
The third byte is an additional option byte: 
bsad. “Ren Open/Close/End of Volume obtaining storage from CSA 
-XXX XXXX Reserved 
The fourth byte is reserved. 


DXATEXC2 contains the last four characters of the module in control (the 
first four characters are assumed to be IDAQ). 
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ISAM-Interface Data-Set Management Recovery Routine (IDAICIA1) 


IDAICIA1 gets control from IDAOCEA1 when an error occurs in 
ISAM-Interface Open or Close processing. To determine what to do, it uses 
audit flags set by IDA0192I or IDAO0200S in the ITAUD fields in the ICB 
control block. The IICB is pointed to by DKATEXC2 in the 
Open/Close/End-of-Volume work area. (The format of the TAUD 
information is given in ‘“‘Data Areas.’’) 


An error may have been caused by the ISAM Interface or by the user. For an 
ISAM-Interface error, IDAICIA1: 


e Issues SDUMP to record information in SYS1. DUMP 


e Issues SETRP to record the STAE diagnostic work area (SDWA) in 
SYS1.LOGREC 


e Closes the associated DCB, which includes: 
Deleting routines 
Freeing storage 
Restoring the DCB 
Unchaining the DEB 


The areas dumped by way of the SDUMP macro are indicated in the address 
list in SDUMPLST, which is associated with the macro. The addresses listed 
are those of: 

The list 

The user’s DCB 

The protected DCB (copied into the VS2 Open work area) 

The Open/Close/End-of-Volume work area 

The SDWA 

The DEB (or 0) 

The IICB (or 0) 

The I/O buffers (or 0) 

The physical-error message area (or 0) 


For a user error, IDAICIA] issues SETRP to record the SDWA in the 
SYSABEND data set. SDWA contains addresses of the areas to be dumped: 
The user’s DCB 
The IICB 
The AMDSB 


It also contains flags that indicate that this program data should be dumped: 
Save areas 
Registers 
Program Status Word 
User subpools 


User errors include ABEND 03B from IDA0192I, ABEND 031 from 
IDAIIPM1 or IDAITISM1, and errors in a DCB exit routine. The next section, 
‘‘ABENDs Issued by VSAM,”’ discusses errors that result in ABENDs. 
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Getting a Dump of Open, Close, and End-of-Volume Work Areas 


The messages that Problem Determination (IDA0192P) issues for Open, 
Close, and End of Volume may not be sufficient to determine what’s wrong. j 


In such a case, you can get an ABEND dump by turning on a bit in the CVT 
(communication vector table) and rerunning the job in error. Use the CPU 
manual procedure AM (alter main storage) to set bit 4 of the first byte of 
CVTAMFF to ‘1’ for VSAM to ABEND. Set bit 6 of the third byte of 
CVTAMFF to ‘1’ to prevent the freeing of work areas. 


| CVTAMFF 





After the error occurs, IDA0192P issues its message and also issues an 
ABEND with a user code of 888. 


The contents of the registers (0-15) of the module that called IDA0192P (the 
same module identified by the function code in the problem-determination 
message) can be found at the address calculated by adding X‘140’ to the 
contents of register 4 at entry to ABEND. 


The caller’s register 13 contains the address of its standard register save area. 
The save areas of modules that had control before an abnormal termination 
are chained together, as shown in Figure 64. 


Open, Close, and End-of-Volume modules (with the exception of IDA0192D, 

IDA0192G, IDA0192I, IDA0192M, and IDA0557A) use a main work area, 

OPWA (often called FORCORE), to communicate with one another. The Ss) 
field DXCCW7 contains the address of IFGO192A’s save area, which 

contains the address of the next save area, and so on. Each save area after 

IFG0192A’s contains the address of the previous save area. By following the 

back chain from the module that called IDA0192P, you can locate the save 

area of each module in Open, Close, or End of Volume that had control 

before the abnormal termination. 


The save area is the first part of each module’s work area (MWA, module 
work area, also called an ADA, automatic data area). It is used to store the 
contents of registers at entry to the next module that gets control. It is 
followed by a visual ID for easy recognition in the EBCDIC part of a dump 
listing. The visual ID contains the name of the module and the Julian date of 
its compilation. 


For an Open or Close request (but not for End of Volume), the first work 
area obtained to process the request points to an OPWA for each ACB or 
DCB to be opened or closed. OPWA points to an area that contains a copy of 
the ACB or DCB. 


During Open processing, register 4 contains the address of the open work 
area (OPW, mapped by IDAOPWRK and also called the ACB work area). 
OPW has the visual ID ‘IDAOPWRK’. 


During Close processing, register 4 contains the address of the close work 
area (CLW, mapped by IDACLWRK). 


The open and close work areas are described in the ““Data Areas” Section. 
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Figure 64. Chaining of Save Areas of O/C/EOV Modules 
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End of Volume uses its own module work area (MWA)—it doesn’t have a 

special work area that corresponds to OPW or CLW. End of Volume’s MWA 

has no visual ID. (Register 13 contains its address during End-of-Volume : 
processing.) J 


Getting a Dump of VSAM Control Blocks in CSA 


Entry and Exit 


Control blocks and storage areas for data processed with the global shared 
resources (GSR) option are built in CSA, and the VSAM SNAP dump facility 
provides hexadecimal printouts of those control blocks and areas. 


To get the dump, SDATA=CB must be specified in the SNAP macro 
(described in OS/VS2 Sypervisor Services and Macro Instructions) or must 
be specified to ABDUMP via the CHNGDUMP operator command or the 
IEAABDO0O member of PARMLIB. Since the dump is actually made during 
SNAP processing, CSA is available anytime during job execution, not just 
during abnormal termination. 


The VSAM SNAP formatting routine, IDAQ195A, receives control from 
SNAP module EAVAD08 (described in OS/VS2 System Logic Library). It 
locates, formats, and passes to the SNAP output routine five types of VSAM 
data in CSA: 


e The JSCBSHR for the TCB being snapped. This field points to the 
valid-AMBL table (VAT) at the head of the VAT chain. 


e The control blocks for any open VSAM GSR data set for the TCB being 
dumped. 


e The control blocks that make up the GSR pool, if there were open GSR 
data sets or if the TCB being dumped is the jobstep TCB which issued the | 
GSR BLDVRP macro. J 


e The VGTT chain for the ASCB associated with the TCB being dumped as 
well as any PSBss associated with these VGTTs. 


The control blocks and storage areas made available by the dump facility are 
shown in Figure 65. On the actual printouts, each block of data is preceded 
by an identifying line that names the data (VSRT, for example) and gives its 
address and length. Output samples are shown in OS/VS2 System 
Programming Library: Debugging Handbook. 


IDAO195A receives control in key 0 supervisor state with no locks held; 
ESTAE has been issued. Register contents upon entry are: 


R1 - Address of IHAABDPL 
R13 - Save area address 

R14 - Return address 

R15 - IDAO195A base address 


Return in most cases will be to the caller, with registers 0 through 14 restored. 
Register 15 contains a return code: zero is normal return, nonzero is an error 
return. A nonzero return code causes VSAM formatting to stop and the 
message “VSAM CONTROL BLOCKS UNAVAILABLE” to appear in the 
dump. 


Should an error occur that precludes the dumping of data, the message - | 
“IDA0195A DATA SUPPRESSED DUE TO ERROR?” will appear in place 
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Range Variables 


of the data. Data will be suppressed because of machine checks and program 
interrupts (for example, address, page, segment, and protection exceptions). 


To prevent endless looping through invalid chained data, IDA0Q195A has 
established range variables for loop detection and control. Control block 
chains will be followed until the range value is reached, and then the routine 
will force a logical end of chain and place the message “EXCESSIVE XXXxX 
DETECTED BY IDA0195A” in the SNAP data set. XXXX describes the 
data being formatted when the suspension occurred. For example, 
“EXCESSIVE GSR PSAB CHAIN DETECTED BY IDAO0195A”. 


The range variables (identified as DEBCNTMX, HEBCNTMX, 
VSAMCBMX, and MAXVCSLN) are grouped in the IDA0195A CSECT. 
Although the variables have been set high to allow for very large VSAM 
structures, they can be changed by using the Service Aid IMASPZAP 
(‘SSUPERZAP’). Modification requires a listing and possibly a dump of 
IDAO195A on the affected system. The variables are located in the following 
IDAO0195A structure: 


Offset Variable Value 

0 Visual ID EBCDIC: THRESHOLD VALUES 
16 DEBCNTMX Decimal 200 

20 HEBCNTMX Decimal 17 

24 VSAMCBMX Decimal 16 

28 MAXVCSLN Decimal 20 


The following list identifies the range variable that influences the display of 
specific data or chains of data: 


Data/Chain Name Range Variable 
TCB DEB Chain DEBCNTMX 
PSB chain of VGTT VSAMCBMX 
VGTT chain VSAMCBMX 
WSHD slot count DIM (WSHDSLT) 
CPA WSHD chain VSAMCBMX 
WSHD chain VSAMCBMX 
VSRT internal CSL list MAXVCSLN 
GSR VMT chain VSAMCBMX 
GSR HEB entries HEBCNTMX 
GSR PSB chain VSAMCBMX 
GSR PSAB chain VSAMCBMX 


Formatting of VSAM information will be suspended without an error message 
when one SNAP exceeds 256 CMBs or BIBs or when a HEB spans the PSB 
in which it resides. When the CMBs or BIBs exceed 256, that portion of 
formatting produces no output while other logic remains operative. Unlike the 
range variables, values for CMBs and BIBs cannot be modified. Increasing 
the BIB and CMB values will rdquire a recompilation, but this should not be 
necessary since these limits exceed the DEB chain variable in size. 
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JSCBSHR: J 





VGTT Chain and Associated PSBs: 


1IDAO195A monitors the following of this chain, and processing may end before all control blocks in the chain are 
formatted. See ‘“‘Range Variables.”’ 


Figure 65 (Part 1 of 3). Control Blocks Made Available by the VSAM SNAP Dump Facility 
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TIDAQI95A monitors the following of this chain, and processing may end before all control blocks in 
the chain are formatted. See ‘‘Range Variables.” 
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Figure 65 (Part 2 of 3). Control Blocks Made Available by the VSAM SNAP Dump Facility 
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1IDA0195A monitors the following of this chain, and processing may end before all control blocks in the chain 
are formatted. See ‘‘Range Variables.”’ 


2This storage is located via the imbedded VSRT CSLs. The other storage is located via chains out of the VSRT 
or by slot entries in WSHDs (WSHDSLT). 


Figure 65 (Part 3 of 3) Control Blocks Made Available by the VSAM SNAP Dump Facility 
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Recovery 


Although covered by mainline SNAP’s recovery routine, IDA0195A 
establishes its own ESTAE environment after gaining control. The ESTAE 
routine, RCVRRTN, returns control to mainline IDA0195A, which displays 
the message ‘IDA0195A DATA SUPPRESSED DUE TO ERROR” and 
concludes VSAM formatting with the message ‘END OF VSAM DATA”. No 
retry is done and percolation from RCVRRTN occurs when: 


« No SDWA is available 
« SDWACLUP=ON (clean-up entry) 
e SDWANRBE=ON (error was not from this RB) 


e Previous retry under this SNAP caused RCVRRTN to gain control 
(recursion) 


RCVRRTN will attempt to record SDWA errors in SYS1.LOGREC, if retry 
is not successful. 


Recovery with Global Shared Resources 


When the user processes data with the GSR (global shared resources) option, 
a task in one address space issues the BLDVRP macro to build the VSAM 
resource pool in global storage. This address space is responsible for issuing 
the DLVRP macro to delete the resource pool. If the address space or the 
region control task terminates without issuing DLVRP, VS2 assumes 
responsibility for deleting the resource pool. 


When the use count (count of data sets open) for the resource pool (in the 
AMCRBS, which is described in the OS/VS2 Catalog Management Logic) 
drops to 0, VS2 issues the DLVRP macro. 


When VS2 forces resource-pool deletion, it sends the standard 
problem-determination message, IEC2511I, to the operator and to the output 
data set of the task that had been responsible for issuing DLVRP. The 
following return codes (rc) and function codes (ccc) indicate what happened: 


rc 176 (BO) Control blocks were dumped into the SYS1.DUMP data set. 

rc 180 (B4) Only some control blocks could be dumped into the 
SYS1.DUMP data set. 

rc 184 (B8) No control blocks could be dumped into the SYS1. DUMP 
data set. 

ccc 148 (94) VSAM Close module IDA0200T issued DLVRP. 

ccc 149 (95) VSAM Task Close Executor, IDAOQCEA2, issued DLVRP. 


In the SYS1.DUMP data set, the dumped control blocks are preceded by 
“TEC251I, VSAM GSR FORCE DLVRP DUMP DATA.” These control 
blocks are dumped: 


e AMCBS 

e VSRT 

e WSHD and storage pointed to by it 

e CPA WSHD and storage pointed to by it 

e Control blocks and storage pointed to by the VSRT core save lists (CSLs) 
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For a forced deletion of the global resource pool, VSAM does not: 
e Set the ACBERFLG return code | 
e Provide GTF tracing - 


e Provide a message in the ACB message area 


ABENDs Issued by VSAM 


The I/O Manager and the ISAM Interface issue ABENDs. The I/O manager 
stores the reason code for an ABEND in register 2 and stores all registers in 
the save area in the IOMB. Figures 65 and 66 list and explain each 
occurrence of an ABEND. 


Reason 
ABEND Code Module Explanation 
377(179) 4(04) IDAM19R3 Error return from issuance of 
SETLOCK macro 
8(08) IGC121 Invalid AMB or IOMB 
12(0C) IGC121 Invalid CPA 
16(10) IGC121 Error in the VS2 PGFIX Routine (it 
returned a code other than 0 or 8) 
20(14) IGC121 Invalid buffer address 
(PAGEOUT 
routine) 
24(18) IDA121A2 Error in converting to real address 
with LRA instruction 
28(1C) IDA121A2 Block size not 4K (4096) for track } 
overflow 
633(279) 4(04) IDA121A4 Invalid BUFC—the virtual storage 
(IDA121F4 originally assigned to the BUFC no 
routine) longer belongs to the user 
20(14) IDA121A4 Protection check indicated in the 


IOSB from the VS2 I/O Supervisor 
(invalid buffer address assumed to 
be the reason) 


Figure 66. I/O-Management ABENDs 
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ABEND 
1(001) 
(a) 


(b) 


49(031) 
(a) 


(b) 


(c) 


(d) 


57(039) 


59(03B) 


Error ABEND 
detected issued 
Error by by 
The user did not specify a SYNAD exit routine. 
I/O error VSAM BISAM 
initially (IDAIIPM3) 
and BISAM 
during 
CHECK 
Invalid BISAM BISAM 
request 


The user did not specify a SYNAD exit routine. 


VSAM physical VSAM SYNAD 

or logical 

error 

Invalid VSAM SYNAD 

request 

Sequence LOAD LOAD 

check (IDAIIPM 1) 

Length error LOAD LOAD 

(RDW greater 

than LRECL) 

End of data VSAM SCAN 

without EODAD (IDAIIPM2) 

routine 

Validity check OPEN OPEN 
(IDA0192I) 


Error indication set 
in DCB or DECB by 


SYNAD (DECB) 
(IDAIISM1) 


BISAM (DECB) 


SYNAD 


GET and SETL 
routines of SCAN 
(IDAITPM2) 


RESUME routine of 
LOAD 


LOAD 


EODAD routine 
of SCAN 


Validity-check 
routine of OPEN 


Catalog values and DCB values for LRECL, KEYLE, or RKP don’t correspond, or, 
with QISAM, DISP is specified OLD when the data set is being opened for output, 
and there are already records in the data set (implying RELOAD). 


Figure 67. ISAM-Interface ABENDs 
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Exception codes may be set in the DCB (for QISAM processing) or the 

DECB (for BISAM processing) in connection with ISAM-Interface ABENDs. 

Figures 68 and 69 give the exception codes. Except where indicated, register ‘ 
15 contains 8, for logical errors. J 





DECB Corresponding Error 
exception RPL feedback detected 
code Explanation code(s) Explanation By 
DECBEXC1 
| eee Record not found 16(10) Record not found VSAM 
24(18) Record on VSAM 
unmountable volume 
oy eee Record-length 108(6C) Record-length VSAM 
check check 
oy eee Space not found 28(1C) Data set not VSAM 
extendable 
eed. gees Invalid request none No RPL available ISAM 
Interface 
20(14) Exclusive-control VSAM 
conflict 
36(24) No key range VSAM 
defined for J 
insertion 
64(40) Placeholder not VSAM 
available 
96(60) Key-change VSAM 
attempted 
Peas) ee Uncorrectable 4-24 A physical error VSAM 
I/O error (04-18) (Register 15 


Unreachable 
block 


contains 12(0C)) 


A logical error 
not covered by 


VSAM 


another exception 
code 


aay Overflow record none ISAM 
(indicated for all Interface 
READ requests) 


ee 1 Duplicate record 8(08) Duplicate record VSAM 


XXXX XX.. Reserved (always none 
0) 


na Channel program none 
initiated by an 
asynchronous routine 
(never indicated, 
always 0) 


sake ee 1 Previous macro was none ISAM 
READ KU Interface 


Figure 68. BISAM Exception Codes in Relation to VSAM Return Codes 
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= 








DECB 
exception 
code Explanation 


| eee? Record not found 


5 eee Invalid device 
address (never 
indicated, always 
0) 


os lamearn Space not found 


Pe teres Invalid request 


rea eee Uncorrectable 
input error 


Pe Uncorrectable 
output error 


sds Unreachable 
block (input) 


sebereus 1 Unreachable 
block (output) 


Cc 


RPL feedback 


code(s) 


none 


16(10) 
24(18) 


none 


28(1C) 


40(28) 


none 


4(04) 


20(14) 


36(24) 


64(40) 


96(60) 


4(04) 
8(08) 


12(0C) 


16(10) 
20(14) 


24(18) 


Explanation 


Record not found 
(SETL K for 
deleted record) 
Record not found 
Record on 
unmountable 
volume 


Data set not 
extendable 
Virtual storage 
not available 


Two consecutive 
SETL requests; 
invalid SETL (I 
or ID); or invalid 
generic key (KEY=0) 
Request issued 
after reaching end 
of data 
Exclusive-control 
conflict 

No key range 
defined for 
insertion 
Placeholder not 
available 
Key-change 
attempted 


Read error in data 
set 

Read error in 
index set 

Read error in 
sequence set 
(Register 15 
contains 12(0C)) 


Write error in 
data set 

Write error in 
index set 

Write error in 
sequence set 
(Register 15 
contains 12(0C)) 


A logical error 
covered by another 
exception code 


A logical error 
not covered by 
another exception 
code 


Figure 69 (Part 1 of 2). QISAM Exception Codes in Relation to VSAM Return Codes 
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DECB Corresponding Error 


exception RPL feedback detected 
code Explanation code(s) Explanation by : 
DCBEXCD2 J 
| Pear Sequence check none Sequence check ISAM 
(during resume Interface 
load only) 
12(0C) Sequence check VSAM 
hy rae Duplicate record 8(08) Duplicate record VSAM 
Poy eens DCB closed when none Error in Close VSAM 
error routine 
entered 
Soules Overflow record none ISAM 
(always indicated) Interface 
Made Lae Length of logical none Length of logical ISAM 
record is greater record is greater Interface 
than DCBLRECL (VLR than DCBLRECL (VLR 
only) only) 
108(6C) Invalid record VSAM 
length 
jew REX Reserved 
(always 0) 


Figure 69 (Part 2 of 2). QISAM Exception Codes in Relation to VSAM Return Codes 








410 OS/VS2 Virtual Storage Access Method (VSAM) Logic 


GLOSSARY 


Acronyms and Abbreviations 


Following is an alphabetized list of the acronyms and 
abbreviations used in this book and in the VSAM code 
listings. If you do not find the term you are looking for, refer 
to the index or to the IBM Data Processing Glossary, 


GC20-1699. 


ABEND 
ABP 


ACB 
ADDR 
ADR 
AIX 
AMB 
AMBL 
AMBXN 
AMDSB 
AMS 
ARDB 
ASCB 


BIB 
BISAM 
BLPRM 
BSPH 
BUFC 
BWD 


Cc 

C/R 
CA 
CCB 
CHKPT 
CI 
CIDF 
CLW 
CMB 
CNV 


core 
CPA 
CRA 
CSA 
CSL 
CVT 


DCB 
DDNAME 
DEB 

DIR 
DIWA 
DSCB 
DSL 
DSNAME 
DSORG 


ECB 
EDB 
ENDREQ 
EOD 
EOF 


abnormal end 

Actual Block Processor 

(either the IOM module IDA121A2 
or the IOM communication vector 
table) 

access method control block 
addressed processing or addressed 
same as ADDR 

alternate index 

access method block 

access method block list 

access method block extension 
access method data statistics block 
Access Method Services 

address range definition block 
address-space control block 


base information block 
Basic ISAM 

resource pool parameter list 
buffer subpool header 
buffer control block 
backward (processing) 


Close 

Checkpoint/Restart 

control area 

command control block 
checkpoint 

control interval 

control interval definition field 
close work area (mapped by IDACLWRK) 
cluster management block 
control interval or 
control-interval processing 
virtual storage 

channel program area 

catalog recovery area 

common service area 

core save list 

communication vector table 


data control block 
data definition name 
data extent block 
direct processing 
data insert work area 
data set control block 
DEB save list 

data set name 

data set organization 


event control block 
extent definition block 
end the request 

end of data 

end of file 


EOV 
EP 


ERFLG 
ESL 
EXCD 
EXCP 
EXLST 
Ext Proc 


FKS 
FS 
FWD 


GC 
GEN 
GSR 


HEB 


ICIP 
ICWA 
ID 
IDAL 


Il 

IICB 
IMWA 
Int Proc 
1/O 
IOB 
IOM 
IOMB 
IOMBXN 
IOSB 
ISAM 


JFCB 
JSCB 
JSTCB 


KEQ 
KEY 
KGE 


L 
LLOR 


LPMB 
LSR 


MACR 
MOD 
MSS 
MSVI 
MWA 


n 
NSI 
NSP 
NUP 


O 
O/C/EOV 
OFLG 
OPTCD 
OPW 
OPWA 


End of Volume 
external procedure entry point 


error flags 

enqueue save list 
exceptional conditions 
execute channel program 
exit list 

external procedure 


full key search 
free space 
forward (processing) 


type code (group code) 
generic key search 
global shared resources 


header element block 


improved control-interval processing 
index create work area 

identifier 

indirect data-address list 

(real page list) 

ISAM Interface 

ISAM interface control block 
index modification work area 
internal procedure 

input/output 

input/output block 

I/O Management 
I/O-Management block 
I/O-Management block extension 
I/O-Supervisor block 

Indexed Sequential Access Method 


job file control block 
job step control block 
job step task control block 


search on key equal 
keyed accessing 
search on key greater or equal 


link 

least length of record (that 
contains all key fields) 
logical-to-physical mapping block 
local shared resources 


macro reference 

module 

Mass Storage System 

mass storage volume inventory 
module work area 


integer number 

next sequential instruction 
next string position 

no update 


Open 

Open/Close/End of Volume 

open flags 

option code 

open work area (mapped by IDAOPWRK) 
common O/C/EOV base work area 
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OPWRK 


OS/VS 


PFL 
PFPL 
PIOD 
PL/I 
PLH 
PROC 
PSB 
PSL 
PSR 
PSW 


QISAM 


RAB 
RBA 
RDF 
RM 
Rn 
RPL 
RPLE 
RPS 
RRDS 
RTM 
RTN 


SCIB 
SCRA 
SDWA 
SEQ 
SIOD 
SKP 


SMF 
SRB 
SSCR 
SSL 
SST 
STRNO 
SVC 


TCB 
TIOT 
TSO 


UCB 
UCRA 


UPD 
UPT 
USAR 
USVR 


VAT 
VCRCORE 
VCRT 
VGTT 
VIOT 
VMT 
VPL 
VRP 
VS 
VSAM 
VSL 





VSAM O/C/EOV ACB work area VSRT 
(mapped by IDAOPWRK) VTOC 
Operating System/Virtual Storage VVIC 
page fix list WAX 
PGFIX parameter list (same as PFL) WSHD 
Problem-State I/O Driver WTG 
—— xcTL 
ide cee 
protected sphere block SREF 


page save list 
Programming Systems Representative 
program status word 


Queued ISAM 


record area block 

relative byte address 

record definition field 

Record Management 
general-purpose register n 
request parameter list 

request parameter list extension 
rotational position sensing 
relative record data set 
recovery/termination manager 
routine 


search compressed index block 
catalog recovery area in system storage 
system diagnostic work area 
sequential or sequential processing 
Supervisor-State I/O Driver 

skip sequential or skip sequential 
processing 

system management facilities 
service request block 

Subsystem checkpoint record 
swap save list 

set sector table 

number of RPL strings 

supervisor call 


task control block 
task I/O table 
time sharing option 


unit control block 

catalog recovery area in user's 
storage 

update mode (or data modify) 
upgrade table 

user security-authorization record 
user security-verification routine 


valid-AMBL table 

VSAM checkpoint/restart core 
VSAM checkpoint/restart table 
VSAM global termination table 
valid-IOMB table 

volume mount table 

virtual page list 

VSAM resource pool 
(Operating System/) Virtual Storage 
Virtual Storage Access Method 
virtual subarea list 

(same as PFL or PFPL) 
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VSAM shared resource table 
volume table of contents 
(replaced by MSVI) 


work area for path processing 
working storage header 
where-to-go table 


transfer control (macro) 
checkpoint 
cross reference 





Definitions of Terms Used In 
This Book 


Access Method Services: A multifunction service program that 
defines VSAM data sets and allocates space for them, 
converts indexed sequential data sets to key-sequenced data 
sets with indexes, modifies data-set attributes in the catalog, 
reorganizes data sets, facilitates data portability between 
Operating systems, creates backup copies of data sets and 
indexes, helps make inaccessible data sets accessible, and lists 
data-set records and catalog entries. 


addressed direct access: The retrieval or storage of a data 
record identified by its relative byte address, independent of 
the record’s location relative to the previously retrieved or 
stored record. (See also keyed direct access, addressed 
sequential access, and keyed sequential access.) 


addressed sequential access: The retrieval or storage of a data 
record in its entry sequence relative to the previously 
retrieved or stored record. (See also keyed sequential access, 
addressed direct access, and keyed direct access.) 


alternate index: A collection of index entries organized by the 
alternate keys of its associated base data records. 


alternate-index cluster: The data and index components of an 
alternate index. 


application: As used in this publication, the use to which an 
access method is put or the end result that it serves; 
contrasted to the internal operation of the access method. 


base cluster: A key-sequenced or entry-sequenced cluster over 
which one or more alternate indexes are built. 


candidate volume: A direct-access storage volume that has 
been defined in a VSAM catalog as a VSAM volume; VSAM 
can automatically allocate space on this volume, as needed. 


catalog: (See master catalog and user catalog.) 
catalog recovery area: (See CRA.) 


CIDF: Control interval definition field. The 4byte 
control-information field at the end of a control interval that 
gives the displacement from the beginning of the control 
interval to free space and the length of the free space. If the 
length is 0, the displacement is to the beginning of the control 
information. 


cluster: A combination of related VSAM data sets, identified 
by one name in a VSAM catalog and requiring a single DD 
statement. A key-sequenced data set and its index form a 
cluster; an entry-sequenced data set alone forms a cluster. 


collating sequence: An ordering assigned to a set of items, such 
that any two sets in that assigned order can be collated. As 
used in this publication, the order defined by the System/370 
8-bit code for alphabetic, numeric, and special characters. 


compendium: A compendium gathers together and presents in 
concise form all the essential facts and details about a VSAM 
functional unit. 


component: As used in this book, a group of modules that 
perform a function, such as I/O Management. 


compression: (See key compression.) 


control area: A group of control intervals used as a unit for 
formatting a data set before adding records to it. Also, ina 


key-sequenced data set, the set of control intervals pointed to 
by a sequence-set index record; used by VSAM for 
distributing free space and for placing a sequence-set index 
record adjacent to its data. 


control-area split: The movement of the contents of some of 
the control intervals in a control area to a newly created 
control area, to facilitate the insertion or lengthening of a 
data record when there are no remaining free control 
intervals in the original control area. 


control interval: A fixed-length area of auxiliary-storage space 
in which VSAM stores records and distributes free space. It is 
the unit of information transmitted to or from auxiliary 
storage by VSAM, some integer multiple of blocksize. 


control-interval split: The movement of some of the stored 
records in a control interval to a free control interval, to 
facilitate the insertion or lengthening of a record that won't 
fit in the original control interval. 


CRA: catalog recovery area. An entry-sequenced data set that 
exists on each volume owned by a recoverable catalog, 
including the catalog volume itself. The CRA contains 
self-describing records as well as duplicates of catalog records 
that describe the volume. 


data integrity: Preservation of data or programs for their 
intended purpose. As used in this publication, the safety of 
data from inadvertent destruction or alteration. 


data record: A collection of items of information from the 
standpoint of its use in an application and not from the 
standpoint of the manner in which it 1s stored (see also stored 
record). 


data security: Prevention of access to or use of data or 
programs without authorization. As used in this publication, 
the safety of data from unauthorized use, theft, or purposeful 
destruction. 


data set: The major unit of data storage and retrieval in the 
operating system, consisting of data in a prescribed 
arrangement and described by control information to which 
the system has access. As used in this publication, a collection 
of fixed- or variable-length records in auxiliary storage, 
arranged by VSAM in key sequence or in entry sequence. 
(See also key-sequenced data set and entry-sequenced data 
set.) 


data space: A storage area defined in the volume table of 
contents of a direct-access volume for the exclusive use of 
VSAM to store data sets, indexes, and catalogs. 


direct access: The retrieval or storage of data by a reference to 
its location in a data set rather than relative to the previously 
retrieved or stored data. (See also addressed direct access 
and keyed direct access.) 


distributed free space: Space reserved within the control 
intervals of a key-sequenced data set for inserting new 
records into the data set in key sequence; also, whole control 
intervals reserved in a control area for the same purpose. 


entry sequence: The order in which data records are physically 
arranged in auxiliary storage, without respect to their 
contents. (Contrast to key sequence.) 
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entry-sequenced data set: A data set whose records are loaded 
without respect to their contents, and whose relative byte 
addresses cannot change. Records are retrieved and stored by 
addressed access, and new records are added at the end of the 
data set. 


extent: A continuous space allocated on a direct-access 
storage volume, reserved for a particular data space or data 
set. 


external procedure: A procedure that can be called by any 
other VSAM procedure; a procedure whose name is in the 
module’s (assembler listing) ‘‘external symbol dictionary”. 


field: In a record or a control block, a specified area used for 
a particular category of data or control information. 


free space: (See distributed free space.) 


generic key: A high-order portion of a key, containing 
characters that identify those records that are significant for a 
certain application. For example, it might be desirable to 
retrieve all records whose keys begin with the generic key AB, 
regardless of the full key values. 


global storage: Virtual storage that is not part of a user’s 
private address space. 


GSR: global shared resources. (See shared resources. ) 


horizontal extension: An extension record pointed to by a 
catalog record’s extension field. (See also vertical extension.) 


horizontal pointer: A pointer in an index rewprd that gives the 
location of another index record in the same level that 
contains the next key in collating sequence; used for keyed 
sequential access. 


index: As used in this publication, an ordered collection of 
pairs, each consisting of a key and a pointer, used by VSAM 
to sequence and locate the records of a key-sequenced data 
set; organized in levels of index records. (See also index 
level, index set, and sequence set.) 


index entry: A key and a pointer paired together, where the 
key is the highest key (in compressed form) entered in an 
index record or contained in a data record in a control 
interval, and the pointer gives the location of that index 
record or control interval. 


index level: A set of index records that order and give the 
location of records in the next lower level or (sequence set 
record) that give the location of control intervals in the 
control area that it is associated with. 


index record: A collection of index entries that are retrieved 
and stored as a group. (Contrast to data record.) 


index replication: The use of an entire track of direct-access 
storage to contain as many copies of a single index record as 
possible; reduces rotational delay. 


index set: The set of index levels above the sequence set. The 
index set and the sequence set together comprise the index. 


index upgrade: The process of reflecting changes made toa 
base cluster in its associated alternate indexes. 


integrity: (See data integrity.) 


internal procedure: A procedure that can be called only by 
other procedures within the module. (See also external 
procedure.) 


ISAM interface: A set of routines that allow a processing 
program coded to use ISAM (indexed sequential access 
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method) to gain access to a key-sequenced data set with an 
index. 


key: One or more characters within an item of data that are 
used to identify it or control its use. As used in this 
publication, one or more consecutive characters taken from a 
data record, used to identify the record and establish its order 
with respect to other records. (See also key field and generic 
key.) 


key compression: The elimination of characters from the front 
and the back of a key that VSAM does not need to distinguish 
the key from the preceding or following key in an index 
record; reduces storage space for an index. 


key field: A field located in the same position in each record 
of a data set, whose contents are used for the key of a record. 


key sequence: The collating sequence of data records, 
determined by the value of the key field in each of the data 
records. May be the same as, or different from, the entry 
sequence of the records. 


key-sequenced data set: A data set whose records are loaded in 
key sequence and controlled by an index. Records are 
retrieved and stored by keyed access or by addressed access, 
and new records are inserted in the data set in key sequence 
by means of distributed free space. Relative byte addresses of 
records can change. 


keyed direct access: The retrieval or storage of a data record 
by use of an index that relates the record’s key to its relative 
location in the data set, independent of the record’s location 
relative to the previously retrieved or stored record. (See also 
addressed direct access, keyed sequential access, and 
addressed sequential access.) 


keyed sequential access: The retrieval or storage of a data 
record in its key sequence relative to the previously retrieved 
or stored record, as defined by the sequence set of an index. 
(See also addressed sequential access, keyed direct access, 
and addressed direct access.) 


local storage: Virtual storage in a user’s private address space. 
LSR: local shared resources. (See shared resources.) 


mass sequential insertion: A technique VSAM uses for keyed 
sequential insertion of two or more records in sequence into a 
collating position in a data set: more efficient than inserting 
each record directly. 


mass storage volume: Two data cartridges in the IBM 3850 
Mass Storage System that contain information equivalent to 
what could be stored on a direct-access storage volume. 


master catalog: A key-sequenced data set with an index 
containing extensive data-set and volume information that 
VSAM requires to locate data sets, to allocate and deallocate 
storage space, to verify the authorization of a program or 
operator to gain access to a data set, and to accumulate usage 
Statistics for data sets. 


memory: As used in this book, a synonym for the private 
address space in virtual storage. 


module: The unit of code that is link-edited. A program 
module has at least one procedure, and may have many. 


password: A unique string of characters stored in a catalog 
that a program, a computer operator, or a terminal user must 
supply to meet security requirements before a program gains 
access to a data set. 


J 


path: A named, logical entity composed of one or more 
clusters (an alternate index and its base cluster, for example). 


physical record: On a track of a direct-access storage device, 
the space between interrecord gaps. 


pointer: An address or other indication of location. For 

example, an RBA is a pointer that gives the relative location 
of a data record or a control interval in the data set to which 
it belongs. (See also horizontal pointer and vertical pointer.) 


portability: The ability to use VSAM data sets with different 
operating systems. Volumes whose data sets are cataloged in 
a user catalog can be demounted from storage devices of one 
system, moved to another system, and mounted on storage 
devices of that system. Individual data sets can be transported 
between operating systems using Access Method Services. 


prime index: The index component of a key-sequenced data 
set having one or more alternate indexes. (See also index and 
alternate index.) 


prime key: The key of reference for a key-sequenced data set 
when it was loaded. (See also key.) 


procedure: A functional unit of VSAM code that is entered 
only at one entry point and exits at the end of the procedure 
(the last line of the procedure’s code). The procedure can call 
(transfer control, with a return to the procedure expected) 
other procedures within the module (internal calls) and can 
call other procedures in other VSAM modules (external 
calls). (See also internal procedure and external procedure.) 


random access: (See direct access.) 


RBA: Relative byte address. The displacement of a data 
record or a control interval from the beginning of the data set 
to which it belongs; independent of the manner in which the 
data set is stored. 


RDF: Record definition field. A 3-byte control-information 
field to the left of the CIDF in a control interval that gives the 
length of a record in the control interval or the number of 
consecutive records having the same length. 


record: (See index record, data record, stored record.) 
relative byte address: (See RBA.) 


relative record data set: A data set whose records are loaded 
into fixed-length slots. 


relative record number: A number that identifies not only the 
slot in a relative record data set but also the record occupying 
the slot. 


replication: (See index replication.) 


reusable data set: A VSAM data set that can be reused as a 
work file, regardless of its old contents. 


security: (See data security.) 


segment: The portion of a spanned record contained within a 
control interval. (See also spanned record.) 


sequence set: The lowest level of the index of a key-sequenced 
data set; it gives the locations of the control intervals in the 
data set and orders them by the key sequence of the data 
records they contain. The sequence set and the index set 
together comprise the index. 


sequential access: The retrieval or storage of a data record in 
either its entry sequence or its key sequence, relative to the 
previously retrieved or stored record. (See also addressed 
sequential access and keyed sequential access.) 


shared resources: The sharing of a pool of I/O-related control 
blocks, channel programs, and buffers among several VSAM 
data sets open at the same time. Resources are shared either 

locally (LSR) or globally (GSR). 


skip sequential access: Keyed sequential retrieval or storage of 
records here and there throughout a data set, skipping 
automatically to the desired record or collating position for 
insertion: VSAM scans the sequence set to find a record ora 
collating position. 


spanned record: A record whose length exceeds 
control-interval length and, as a result, crosses or spans one 
or more control-interval boundaries within a single control 
area. 


sphere: The collection of base cluster, alternate indexes, and 
upgrade alternate indexes opened to process one or more 
paths related to the same Base Information Block (BIB). 


stored record: A data record, together with its control 
information, as stored in auxiliary storage. 


string: The part of a control block structure built around a 
placeholder (PLH) that enables VSAM to keep track of one 
position in the data set that the control block structure 
describes. 


upgrade set: All the alternate indexes that VSAM has been 
instructed to update whenever there is a change to the data 
component of the base cluster. 


user catalog: A catalog used in the same way as the master 
catalog, but optional and pointed to by the master catalog, 
and also used to lessen the contention for the master catalog 
and to facilitate volume portability. 


vertical extension: An extension record pointed to by a 
set-of-fields pointer in the object’s base catalog record or its 
horizontal extension. (See also base catalog record and 
horizontal extension.) 


vertical pointer: A pointer in an index record of a given level 
that gives the location of an index record in the next lower 
level or the location of a control interval in the data set 
controlled by the index. 
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Problem-State I/O Driver (IDAM19R3) 271,282 
procedure directory 277 
processing more than one record with a single macro 
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read-ahead buffering 158,259 
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Close processing 48,54 
control block structure 303 
deleting a resource pool (DLVRP) 58,212 
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program 171 
SETLOCK macro 377 
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managing I/O buffers 
MARKBFR 148 
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Type 64 
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requirements for End-of-Volume processing 169 
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format 285 
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entry 123 

SQICHECK (IDA019R4) 93,228 
SRB control block 

built by Open 196 

description of 356 

mapped by IHASRB macro 376 

used by OS/VS2 I/O Supervisor 184 
SSCR (See subsystem checkpoint record) 
SSL control block 

built and used by OPEN 28 

description of 356 

mapped by IDASSL macro 374 
STAE exits (See ESTAE exits) 
Stage II Exit Effector, OS/VS2 187,268 
staging data from mass storage 

End of Volume 168,231 

Open 197 

temporary Close 57,209 
starting-search index level 89 
STARTIO macro 184,266,278 
STARTIOX (IDA173A2) 133 
STEPCAT JCL DD statement 29 
storage blocks used in virtual-storage management 394 
storage layout, virtual 18 
storage management, virtual 391 
stored record 285 
STOREUCB (IGC121) 183 
string addition, dynamic 27,200 
subpools, control block placement in 18,305 
subsystem checkpoint record 

built 71 

processed 73 
Supervisor-Call (SVC) processing program 17 
Supervisor-State I/O Driver (IGC121) 276,282 
SVC processor 17 
SVC 13 59 
SVC 19—issued by ISAM Interface 26,195 
SVC 20—issued by ISAM Interface 40 
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SVC 26 (LOCATE) 29,31,208,210 
SVC 29 (SCRATCH) 210 
SVC 52 (RESTRT) 216 
SVC 55 93,103,167 
SVC 63 (CHKPT) 214 
SVC121—issued by I/O Management 180 
SVCLIB library and VSAM load modules 282 
symbol-where-used report, description of 368 
SYNAD exit routine 385 

register contents on entry to 385 
SYNAD—ISAM-user’s macro 

and CHECK processing 135 

issued by a QISAM-user’s program 173 
SYNADAF message 385 

built by the ISAM-Interface SYNAD routine 173 
SYNCH macro 378 

issued by Close processing 41 

issued by restart 77 
synchronous request processing—deferred 87 
system library and VSAM load modules 281 
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System Management Facilities (SMF) 
OS/VS (See OS/VS System Management Facilities (SMF)) 
used to count EXCPs 183 
VSAM writes records to the SMF dataset 39,31,169 
SYSVSAM (major resource for ENQ) 41,31,55 
SYS1.DUMP 396 
SYS1.LOGREC 396 
SYS1.SYSJOBQE data set 26 
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Task Close Executor 27 
Task Close, OS/VS2 27,196,264 
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TCLOSE (IDAO0C06C) 69 
TCLSBASE (IDA0231T) 55,57 
TCLSPATH (IDA0231T) 55 
TCLSUPGR (IDA0231T) 55,57 
temporary close (TYPE=T) 
method of operation 54 
program organization 206 
TERM (IDA0557A) 169 
terminating a data request (ENDREQ processing) 
during data set creating 133 
not during dataset creation 131 
TERM192A (IDA0192A) 39 
TERM200T (IDA0200T) 41 
TESTAUTH macro 378 
TESTCB macro 378 
TESTEOV (IGC121) 183 
testing the contents of a control block 177 
TIME macro 378 
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UCRA (catalog recovery area in user storage) 28,44 
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UPCATDEQ (IDA0200B) 51 
UPCATDEQ (IDA0231B) 57 
update write channel program 328 
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updating the index 
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data set) 249 
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Close 40 
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upgrade table (UPT) 
built by Open 34 
description of 357 
mapped by IDAUPT macro 375 
used for alternate-index upgrade 156 
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UPSMF (IDA0231B) 57 
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description of 357 
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user macros (See OS/VS Virtual Storage Access Method 
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built by Open 197 
description of 358 
mapped by IDAVAT macro 375 
used by Open 36 
used by restart 73 
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described 360 
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VERIFY macro 137,378 
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VGTT control block 
description of 361 
mapped by IDAVGTT macro 375 
used by Close 48 
used by restart 75 
used by Task Close Executor 62 
VIOT 
description of 362 
mapped by IDAVIOT macro 375 
VIRTPROC (IDA0200B) 51 
VIRTPROC (IDA0231B) 57 
virtual page list (VPL) 130 
virtual subarea list (VSL) 182 
virtual-storage layout 18 
virtual-storage management 395 
VMT control block 
built by Open 30 
description of 362 
mapped by IDAVMT macro 375 
VMTPROC (IDA0200T) 47 
VOLLOC (IDA0557A) 167 
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during Open processing 30 
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VSAM 
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load modules 282 - 


modules—residence in pageable link pack area 17 
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request processing—method of operation diagrams 82 
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transient routines 282 
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built by checkpoint 69 
described 359 
mapped by IDAVCRT 375 
VSAM-Interface Routine, during Open processing 29 
VSAMCBMX (IDAO195A) 401 
VSL (virtual subarea list) 182 
VSRT control block 
built by BLDVRP 58 
description of 363 
mapped by IDAVSRT macro 373 
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WAX control block 
built by Open 197 
description of 364 
mapped by IDAWAX macro 375 
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(See also WSHD control block) 
WRTBER request 
Close processing 51 
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method of operation 150 
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writing the last record before closing a data set 41 
WSHD control block 
built by Open 28 
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mapped by IDAWSHD macro 375 
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